/[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 992 by iliev, Wed Dec 20 19:52:00 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.31 (http://xml.resource.org/)">
7  <style type='text/css'>  <style type='text/css'><!--
8  <!--          body {
9      body {                  font-family: verdana, charcoal, helvetica, arial, sans-serif;
10          font-family: verdana, charcoal, helvetica, arial, sans-serif;                  font-size: small; color: #000; background-color: #FFF;
11          margin: 2em;                  margin: 2em;
12          font-size: small ; color: #000000 ; background-color: #ffffff ; }          }
13      .title { color: #990000; font-size: x-large ;          h1, h2, h3, h4, h5, h6 {
14          font-weight: bold; text-align: right;                  font-family: helvetica, monaco, "MS Sans Serif", arial, sans-serif;
15          font-family: helvetica, monaco, "MS Sans Serif", arial, sans-serif;                  font-weight: bold; font-style: normal;
16          background-color: transparent; }          }
17      .filename { color: #666666; font-size: 18px; line-height: 28px;          h1 { color: #900; background-color: transparent; text-align: right; }
18          font-weight: bold; text-align: right;          h3 { color: #333; background-color: transparent; }
19          font-family: helvetica, arial, sans-serif;  
20          background-color: transparent; }          td.RFCbug {
21      td.rfcbug { background-color: #000000 ; width: 30px ; height: 30px ;                  font-size: x-small; text-decoration: none;
22          text-align: justify; vertical-align: middle ; padding-top: 2px ; }                  width: 30px; height: 30px; padding-top: 2px;
23      td.rfcbug span.RFC { color: #666666; font-weight: bold; text-decoration: none;                  text-align: justify; vertical-align: middle;
24          background-color: #000000 ;                  background-color: #000;
25          font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;          }
26          font-size: x-small ; }          td.RFCbug span.RFC {
27      td.rfcbug span.hotText { color: #ffffff; font-weight: normal; text-decoration: none;                  font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;
28          text-align: center ;                  font-weight: bold; color: #666;
29          font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;          }
30          font-size: x-small ; background-color: #000000; }          td.RFCbug span.hotText {
31  /* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */                  font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;
32      div#counter{margin-top: 100px}                  font-weight: normal; text-align: center; color: #FFF;
33            }
34      a.info{  
35          position:relative; /*this is the key*/          table.TOCbug { width: 30px; height: 15px; }
36          z-index:24;          td.TOCbug {
37          text-decoration:none}                  text-align: center; width: 30px; height: 15px;
38                    color: #FFF; background-color: #900;
39      a.info:hover{z-index:25; background-color:#990000 ; color: #ffffff ;}          }
40            td.TOCbug a {
41      a.info span{display: none}                  font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif;
42                    font-weight: bold; font-size: x-small; text-decoration: none;
43      a.info:hover span.info{ /*the span will display just on :hover state*/                  color: #FFF; background-color: transparent;
44          display:block;          }
45          position:absolute;  
46          font-size: smaller ;          td.header {
47          top:2em; left:2em; width:15em;                  font-family: arial, helvetica, sans-serif; font-size: x-small;
48          padding: 2px ;                  vertical-align: top; width: 33%;
49          border:1px solid #333333;                  color: #FFF; background-color: #666;
50          background-color:#eeeeee; color:#990000;          }
51          text-align: left ;}          td.author { font-weight: bold; font-size: x-small; margin-left: 4em; }
52            td.author-text { font-size: x-small; }
53       A { font-weight: bold; }  
54       A:link { color: #990000; background-color: transparent ; }          /* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */
55       A:visited { color: #333333; background-color: transparent ; }          a.info {
56       A:active { color: #333333; background-color: transparent ; }                  /* This is the key. */
57                    position: relative;
58      p { margin-left: 2em; margin-right: 2em; }                  z-index: 24;
59      p.copyright { font-size: x-small ; }                  text-decoration: none;
60      p.toc { font-size: small ; font-weight: bold ; margin-left: 3em ;}          }
61            a.info:hover {
62      span.emph { font-style: italic; }                  z-index: 25;
63      span.strong { font-weight: bold; }                  color: #FFF; background-color: #900;
64      span.verb, span.vbare { font-family: "Courier New", Courier, monospace ; }          }
65            a.info span { display: none; }
66      span.vemph { font-style: italic; font-family: "Courier New", Courier, monospace ; }          a.info:hover span.info {
67      span.vstrong { font-weight: bold; font-family: "Courier New", Courier, monospace ; }                  /* The span will display just on :hover state. */
68      span.vdeluxe { font-weight: bold; font-style: italic; font-family: "Courier New", Courier, monospace ; }                  display: block;
69                    position: absolute;
70      ol.text { margin-left: 2em; margin-right: 2em; }                  font-size: smaller;
71      ul.text { margin-left: 2em; margin-right: 2em; }                  top: 2em; left: -5em; width: 15em;
72      li { margin-left: 3em;  }                  padding: 2px; border: 1px solid #333;
73                    color: #900; background-color: #EEE;
74      pre { margin-left: 3em; color: #333333;  background-color: transparent;                  text-align: left;
75          font-family: "Courier New", Courier, monospace ; font-size: small ;          }
76          text-align: left;  
77          }          a { font-weight: bold; }
78            a:link    { color: #900; background-color: transparent; }
79      h3 { color: #333333; font-size: medium ;          a:visited { color: #633; background-color: transparent; }
80          font-family: helvetica, arial, sans-serif ;          a:active  { color: #633; background-color: transparent; }
81          background-color: transparent; }  
82      h4 { font-size: small; font-family: helvetica, arial, sans-serif ; }          p { margin-left: 2em; margin-right: 2em; }
83            p.copyright { font-size: x-small; }
84      table.bug { width: 30px ; height: 15px ; }          p.toc { font-size: small; font-weight: bold; margin-left: 3em; }
85      td.bug { color: #ffffff ; background-color: #990000 ;          table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; }
86          text-align: center ; width: 30px ; height: 15px ;          td.toc { font-size: small; font-weight: bold; vertical-align: text-top; }
87           }  
88      td.bug A.link2 { color: #ffffff ; font-weight: bold;          ol.text { margin-left: 2em; margin-right: 2em; }
89          text-decoration: none;          ul.text { margin-left: 2em; margin-right: 2em; }
90          font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif;          li      { margin-left: 3em; }
91          font-size: x-small ; background-color: transparent }  
92            /* RFC-2629 <spanx>s and <artwork>s. */
93      td.header { color: #ffffff; font-size: x-small ;          em     { font-style: italic; }
94          font-family: arial, helvetica, sans-serif; vertical-align: top;          strong { font-weight: bold; }
95          background-color: #666666 ; width: 33% ; }          dfn    { font-weight: bold; font-style: normal; }
96      td.author { font-weight: bold; margin-left: 4em; font-size: x-small ; }          cite   { font-weight: normal; font-style: normal; }
97      td.author-text { font-size: x-small; }          tt     { color: #036; }
98      table.data { vertical-align: top ; border-collapse: collapse ;          tt, pre, pre dfn, pre em, pre cite, pre span {
99          border-style: solid solid solid solid ;                  font-family: "Courier New", Courier, monospace; font-size: small;
100          border-color: black black black black ;          }
101          font-size: small ; text-align: center ; }          pre {
102      table.data th { font-weight: bold ;                  text-align: left; padding: 4px;
103          border-style: solid solid solid solid ;                  color: #000; background-color: #CCC;
104          border-color: black black black black ; }          }
105      table.data td {          pre dfn  { color: #900; }
106          border-style: solid solid solid solid ;          pre em   { color: #66F; background-color: #FFC; font-weight: normal; }
107          border-color: #333333 #333333 #333333 #333333 ; }          pre .key { color: #33C; font-weight: bold; }
108            pre .id  { color: #900; }
109      hr { height: 1px }          pre .str { color: #000; background-color: #CFF; }
110  -->          pre .val { color: #066; }
111  </style>          pre .rep { color: #909; }
112            pre .oth { color: #000; background-color: #FCF; }
113            pre .err { background-color: #FCC; }
114    
115            /* RFC-2629 <texttable>s. */
116            table.full, table.headers, table.none {
117                    font-size: small; text-align: center; border-width: 2px;
118                    vertical-align: top; border-collapse: collapse;
119            }
120            table.full { border-style: solid; border-color: black; }
121            table.headers, table.none { border-style: none; }
122            th {
123                    font-weight: bold; border-color: black;
124                    border-width: 2px 2px 3px 2px;
125            }
126            table.full th { border-style: solid; }
127            table.headers th { border-style: none none solid none; }
128            table.none th { border-style: none; }
129            table.full td {
130                    border-style: solid; border-color: #333;
131                    border-width: 1px 2px;
132            }
133            table.headers td, table.none td { border-style: none; }
134    
135            hr { height: 1px; }
136            hr.insert {
137                    width: 80%; border-style: none; border-width: 0;
138                    color: #CCC; background-color: #CCC;
139            }
140    --></style>
141  </head>  </head>
142  <body>  <body>
143  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
144  <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">
145  <tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr>  <tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr>
146  <tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr>  <tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr>
147  <tr><td class="header">Expires: November 2, 2005</td><td class="header">Engineering e. V.</td></tr>  <tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr>
148  <tr><td class="header">&nbsp;</td><td class="header">May 2005</td></tr>  <tr><td class="header">Expires: June 23, 2007</td><td class="header">December 20, 2006</td></tr>
149  </table></td></tr></table>  </table></td></tr></table>
150  <div align="right"><span class="title"><br />LinuxSampler Control Protocol</span></div>  <h1><br />LinuxSampler Control Protocol<br />LSCP 1.2</h1>
 <div align="right"><span class="title"><br />LSCP 1.1</span></div>  
151    
152  <h3>Status of this Memo</h3>  <h3>Status of this Memo</h3>
153  <p>  <p>
154  This document is an Internet-Draft and is  By submitting this Internet-Draft,
155  in full conformance with all provisions of Section&nbsp;10 of RFC&nbsp;2026.</p>  each author represents that any applicable patent or other IPR claims of which
156    he or she is aware have been or will be disclosed,
157    and any of which he or she becomes aware will be disclosed,
158    in accordance with Section&nbsp;6 of BCP&nbsp;79.</p>
159  <p>  <p>
160  Internet-Drafts are working documents of the Internet Engineering  Internet-Drafts are working documents of the Internet Engineering
161  Task Force (IETF), its areas, and its working groups.  Task Force (IETF), its areas, and its working groups.
# Line 142  The list of current Internet-Drafts can Line 173  The list of current Internet-Drafts can
173  The list of Internet-Draft Shadow Directories can be accessed at  The list of Internet-Draft Shadow Directories can be accessed at
174  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>
175  <p>  <p>
176  This Internet-Draft will expire on November 2, 2005.</p>  This Internet-Draft will expire on June 23, 2007.</p>
177    
178  <h3>Copyright Notice</h3>  <h3>Copyright Notice</h3>
179  <p>  <p>
180  Copyright &copy; The Internet Society (2005). All Rights Reserved.</p>  Copyright &copy; The Internet Society (2006).</p>
181    
182  <h3>Abstract</h3>  <h3>Abstract</h3>
183    
# Line 169  Introduction<br /> Line 200  Introduction<br />
200  Focus of this protocol<br />  Focus of this protocol<br />
201  <a href="#anchor4">5.</a>&nbsp;  <a href="#anchor4">5.</a>&nbsp;
202  Communication Overview<br />  Communication Overview<br />
203  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor5">5.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor5">5.1.</a>&nbsp;
204  Request/response communication method<br />  Request/response communication method<br />
205  &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;
206  Result format<br />  Result format<br />
207  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor7">5.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor7">5.2.</a>&nbsp;
208  Subscribe/notify communication method<br />  Subscribe/notify communication method<br />
209  <a href="#control_commands">6.</a>&nbsp;  <a href="#control_commands">6.</a>&nbsp;
210  Description for control commands<br />  Description for control commands<br />
211  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor8">6.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor8">6.1.</a>&nbsp;
212  Ignored lines and comments<br />  Ignored lines and comments<br />
213  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor9">6.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor9">6.2.</a>&nbsp;
214  Configuring audio drivers<br />  Configuring audio drivers<br />
215  &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;
216  Getting amount of available audio output drivers<br />  Getting amount of available audio output drivers<br />
217  &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;
218  Getting all available audio output drivers<br />  Getting all available audio output drivers<br />
219  &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;
220  Getting information about a specific audio  Getting information about a specific audio
221                  output driver<br />                  output driver<br />
222  &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;
223  Getting information about specific audio  Getting information about specific audio
224                  output driver parameter<br />                  output driver parameter<br />
225  &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;
226  Creating an audio output device<br />  Creating an audio output device<br />
227  &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;
228  Destroying an audio output device<br />  Destroying an audio output device<br />
229  &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;
230  Getting all created audio output device count<br />  Getting all created audio output device count<br />
231  &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;
232  Getting all created audio output device list<br />  Getting all created audio output device list<br />
233  &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;
234  Getting current settings of an audio output device<br />  Getting current settings of an audio output device<br />
235  &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;
236  Changing settings of audio output devices<br />  Changing settings of audio output devices<br />
237  &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;
238  Getting information about an audio channel<br />  Getting information about an audio channel<br />
239  &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;
240  Getting information about specific audio channel parameter<br />  Getting information about specific audio channel parameter<br />
241  &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;
242  Changing settings of audio output channels<br />  Changing settings of audio output channels<br />
243  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor10">6.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor10">6.3.</a>&nbsp;
244  Configuring MIDI input drivers<br />  Configuring MIDI input drivers<br />
245  &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;
246  Getting amount of available MIDI input drivers<br />  Getting amount of available MIDI input drivers<br />
247  &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;
248  Getting all available MIDI input drivers<br />  Getting all available MIDI input drivers<br />
249  &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;
250  Getting information about a specific MIDI input driver<br />  Getting information about a specific MIDI input driver<br />
251  &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;
252  Getting information about specific MIDI input driver parameter<br />  Getting information about specific MIDI input driver parameter<br />
253  &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;
254  Creating a MIDI input device<br />  Creating a MIDI input device<br />
255  &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;
256  Destroying a MIDI input device<br />  Destroying a MIDI input device<br />
257  &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;
258  Getting all created MIDI input device count<br />  Getting all created MIDI input device count<br />
259  &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;
260  Getting all created MIDI input device list<br />  Getting all created MIDI input device list<br />
261  &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;
262  Getting current settings of a MIDI input device<br />  Getting current settings of a MIDI input device<br />
263  &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;
264  Changing settings of MIDI input devices<br />  Changing settings of MIDI input devices<br />
265  &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;
266  Getting information about a MIDI port<br />  Getting information about a MIDI port<br />
267  &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;
268  Getting information about specific MIDI port parameter<br />  Getting information about specific MIDI port parameter<br />
269  &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;
270  Changing settings of MIDI input ports<br />  Changing settings of MIDI input ports<br />
271  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor11">6.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor11">6.4.</a>&nbsp;
272  Configuring sampler channels<br />  Configuring sampler channels<br />
273  &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;
274  Loading an instrument<br />  Loading an instrument<br />
275  &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;
276  Loading a sampler engine<br />  Loading a sampler engine<br />
277  &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;
278  Getting all created sampler channel count<br />  Getting all created sampler channel count<br />
279  &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;
280  Getting all created sampler channel list<br />  Getting all created sampler channel list<br />
281  &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;
282  Adding a new sampler channel<br />  Adding a new sampler channel<br />
283  &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;
284  Removing a sampler channel<br />  Removing a sampler channel<br />
285  &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;
286  Getting amount of available engines<br />  Getting amount of available engines<br />
287  &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;
288  Getting all available engines<br />  Getting all available engines<br />
289  &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;
290  Getting information about an engine<br />  Getting information about an engine<br />
291  &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;
292  Getting sampler channel information<br />  Getting sampler channel information<br />
293  &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;
294  Current number of active voices<br />  Current number of active voices<br />
295  &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;
296  Current number of active disk streams<br />  Current number of active disk streams<br />
297  &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;
298  Current fill state of disk stream buffers<br />  Current fill state of disk stream buffers<br />
299  &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;
300  Setting audio output device<br />  Setting audio output device<br />
301  &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_TYPE">6.4.15.</a>&nbsp;
302  Setting audio output type<br />  Setting audio output type<br />
303  &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;
304  Setting audio output channel<br />  Setting audio output channel<br />
305  &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;
306  Setting MIDI input device<br />  Setting MIDI input device<br />
307  &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;
308  Setting MIDI input type<br />  Setting MIDI input type<br />
309  &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;
310  Setting MIDI input port<br />  Setting MIDI input port<br />
311  &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;
312  Setting MIDI input channel<br />  Setting MIDI input channel<br />
313  &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;
314  Setting channel volume<br />  Setting channel volume<br />
315  &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;
316  Muting a sampler channel<br />  Muting a sampler channel<br />
317  &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;
318  Soloing a sampler channel<br />  Soloing a sampler channel<br />
319  &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="#SET CHANNEL MIDI_INSTRUMENT_MAP">6.4.24.</a>&nbsp;
320    Assigning a MIDI instrument map to a sampler channel<br />
321    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.25.</a>&nbsp;
322  Resetting a sampler channel<br />  Resetting a sampler channel<br />
323  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
324  Controlling connection<br />  Controlling connection<br />
325  &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;
326  Register front-end for receiving event messages<br />  Register front-end for receiving event messages<br />
327  &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;
328  Unregister front-end for not receiving event messages<br />  Unregister front-end for not receiving event messages<br />
329  &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;
330  Enable or disable echo of commands<br />  Enable or disable echo of commands<br />
331  &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;
332  Close client connection<br />  Close client connection<br />
333  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor13">6.6</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor13">6.6.</a>&nbsp;
334  Global commands<br />  Global commands<br />
335  &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;
336    Current number of active voices<br />
337    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_VOICE_COUNT_MAX">6.6.2.</a>&nbsp;
338    Maximum amount of active voices<br />
339    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET">6.6.3.</a>&nbsp;
340  Reset sampler<br />  Reset sampler<br />
341  &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;
342  General sampler informations<br />  General sampler informations<br />
343    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#MIDI Instrument Mapping">6.7.</a>&nbsp;
344    MIDI Instrument Mapping<br />
345    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#ADD MIDI_INSTRUMENT MAP">6.7.1.</a>&nbsp;
346    Create a new MIDI instrument map<br />
347    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#REMOVE MIDI_INSTRUMENT_MAP">6.7.2.</a>&nbsp;
348    Delete one particular or all MIDI instrument maps<br />
349    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENT_MAPS">6.7.3.</a>&nbsp;
350    Get amount of existing MIDI instrument maps<br />
351    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INSTRUMENT_MAPS">6.7.4.</a>&nbsp;
352    Getting all created MIDI instrument maps<br />
353    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENT_MAP INFO">6.7.5.</a>&nbsp;
354    Getting MIDI instrument map information<br />
355    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET MIDI_INSTRUMENT_MAP NAME">6.7.6.</a>&nbsp;
356    Renaming a MIDI instrument map<br />
357    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#MAP MIDI_INSTRUMENT">6.7.7.</a>&nbsp;
358    Create or replace a MIDI instrument map entry<br />
359    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENTS">6.7.8.</a>&nbsp;
360    Getting ammount of MIDI instrument map entries<br />
361    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INSTRUMENTS">6.7.9.</a>&nbsp;
362    Getting indeces of all entries of a MIDI instrument map<br />
363    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#UNMAP MIDI_INSTRUMENT">6.7.10.</a>&nbsp;
364    Remove an entry from the MIDI instrument map<br />
365    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENT INFO">6.7.11.</a>&nbsp;
366    Get current settings of MIDI instrument map entry<br />
367    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CLEAR MIDI_INSTRUMENTS">6.7.12.</a>&nbsp;
368    Clear MIDI instrument map<br />
369  <a href="#command_syntax">7.</a>&nbsp;  <a href="#command_syntax">7.</a>&nbsp;
370  Command Syntax<br />  Command Syntax<br />
371  <a href="#events">8.</a>&nbsp;  <a href="#events">8.</a>&nbsp;
372  Events<br />  Events<br />
373  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL">8.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT">8.1.</a>&nbsp;
374    Number of audio output devices changed<br />
375    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO">8.2.</a>&nbsp;
376    Audio output device's settings changed<br />
377    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_COUNT">8.3.</a>&nbsp;
378    Number of MIDI input devices changed<br />
379    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_INFO">8.4.</a>&nbsp;
380    MIDI input device's settings changed<br />
381    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a>&nbsp;
382  Number of sampler channels changed<br />  Number of sampler channels changed<br />
383  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.6.</a>&nbsp;
384  Number of active voices changed<br />  Number of active voices changed<br />
385  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.7.</a>&nbsp;
386  Number of active disk streams changed<br />  Number of active disk streams changed<br />
387  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.8.</a>&nbsp;
388  Disk stream buffer fill state changed<br />  Disk stream buffer fill state changed<br />
389  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE INFO">8.5</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;
390  Channel information changed<br />  Channel information changed<br />
391  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.6</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.10.</a>&nbsp;
392    Total number of active voices changed<br />
393    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.11.</a>&nbsp;
394    Number of MIDI instrument maps changed<br />
395    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.12.</a>&nbsp;
396    MIDI instrument map information changed<br />
397    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.13.</a>&nbsp;
398    Number of MIDI instruments changed<br />
399    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.14.</a>&nbsp;
400    MIDI instrument information changed<br />
401    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.15.</a>&nbsp;
402  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
403  <a href="#anchor14">9.</a>&nbsp;  <a href="#anchor14">9.</a>&nbsp;
404  Security Considerations<br />  Security Considerations<br />
# Line 333  Intellectual Property and Copyright Stat Line 414  Intellectual Property and Copyright Stat
414  <br clear="all" />  <br clear="all" />
415    
416  <a name="anchor1"></a><br /><hr />  <a name="anchor1"></a><br /><hr />
417  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
418  <a name="rfc.section.1"></a><h3>1.&nbsp;Requirements notation</h3>  <a name="rfc.section.1"></a><h3>1.&nbsp;
419    Requirements notation</h3>
420    
421  <p>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL",  <p>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL",
422              "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",              "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",
423              and "OPTIONAL" in this document are to be interpreted as              and "OPTIONAL" in this document are to be interpreted as
424              described in <a class="info" href="#RFC2119">[RFC2119]<span> (</span><span class="info">Bradner, S., &ldquo;Key words for use in RFCs to Indicate Requirement Levels,&rdquo; 1997.</span><span>)</span></a>.              described in <a class='info' href='#RFC2119'>[RFC2119]<span> (</span><span class='info'>Bradner, S., &ldquo;Key words for use in RFCs to Indicate Requirement Levels,&rdquo; 1997.</span><span>)</span></a>.
425  </p>  </p>
426  <p>This protocol is always case-sensitive if not explicitly  <p>This protocol is always case-sensitive if not explicitly
427              claimed the opposite.              claimed the opposite.
# Line 359  Intellectual Property and Copyright Stat Line 441  Intellectual Property and Copyright Stat
441  <p>&nbsp;&nbsp;&nbsp;"another line"  <p>&nbsp;&nbsp;&nbsp;"another line"
442  </p>  </p>
443  </blockquote><p>  </blockquote><p>
444                
445  </p>  </p>
446  <p>must actually be interpreted as client sending the following  <p>must actually be interpreted as client sending the following
447              message:              message:
# Line 371  Intellectual Property and Copyright Stat Line 453  Intellectual Property and Copyright Stat
453                      line&lt;CR&gt;&lt;LF&gt;"                      line&lt;CR&gt;&lt;LF&gt;"
454  </p>  </p>
455  </blockquote><p>  </blockquote><p>
456                
457  </p>  </p>
458  <p>where &lt;CR&gt; symbolizes the carriage return character and  <p>where &lt;CR&gt; symbolizes the carriage return character and
459              &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 468  Intellectual Property and Copyright Stat
468  <p>S: "abcd"  <p>S: "abcd"
469  </p>  </p>
470  </blockquote><p>  </blockquote><p>
471                
472  </p>  </p>
473  <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
474              following sequence scenario:              following sequence scenario:
# Line 409  Intellectual Property and Copyright Stat Line 491  Intellectual Property and Copyright Stat
491                      "&lt;LF&gt;"                      "&lt;LF&gt;"
492  </li>  </li>
493  </ul><p>  </ul><p>
494                
495  </p>  </p>
496  <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
497              return and line feed characters respectively.              return and line feed characters respectively.
498  </p>  </p>
499  <a name="LSCP versioning"></a><br /><hr />  <a name="LSCP versioning"></a><br /><hr />
500  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
501  <a name="rfc.section.2"></a><h3>2.&nbsp;Versioning of this specification</h3>  <a name="rfc.section.2"></a><h3>2.&nbsp;
502    Versioning of this specification</h3>
503    
504  <p>LSCP will certainly be extended and enhanced by-and-by. Each official  <p>LSCP will certainly be extended and enhanced by-and-by. Each official
505              release of the LSCP specification will be tagged with a unique version              release of the LSCP specification will be tagged with a unique version
506              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
507              number like:              number like:
508                
509  </p>  </p>
510  <p>  <p>
511                  </p>                  </p>
# Line 430  Intellectual Property and Copyright Stat Line 513  Intellectual Property and Copyright Stat
513  <p>"1.2"  <p>"1.2"
514  </p>  </p>
515  </blockquote><p>  </blockquote><p>
516                
517  </p>  </p>
518  <p>  <p>
519              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 523  Intellectual Property and Copyright Stat
523              compatible to the connected sampler if and only if the LSCP versions              compatible to the connected sampler if and only if the LSCP versions
524              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
525              following rules:              following rules:
526                
527  </p>  </p>
528  <p>Compatibility:  <p>Compatibility:
529  </p>  </p>
# Line 454  Intellectual Property and Copyright Stat Line 537  Intellectual Property and Copyright Stat
537                      the sampler's LSCP minor version.                      the sampler's LSCP minor version.
538  </li>  </li>
539  </ol><p>  </ol><p>
540                
541  </p>  </p>
542  <p>  <p>
543              Compatibility can only be claimed if both rules are true.              Compatibility can only be claimed if both rules are true.
544              The frontend can use the              The frontend can use the
545              <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
546              get the version of the LSCP specification the sampler complies with.              get the version of the LSCP specification the sampler complies with.
547                
548  </p>  </p>
549  <a name="anchor2"></a><br /><hr />  <a name="anchor2"></a><br /><hr />
550  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
551  <a name="rfc.section.3"></a><h3>3.&nbsp;Introduction</h3>  <a name="rfc.section.3"></a><h3>3.&nbsp;
552    Introduction</h3>
553    
554  <p>LinuxSampler is a so called software sampler application  <p>LinuxSampler is a so called software sampler application
555              capable to playback audio samples from a computer's Random              capable to playback audio samples from a computer's Random
# Line 485  Intellectual Property and Copyright Stat Line 569  Intellectual Property and Copyright Stat
569              there.              there.
570  </p>  </p>
571  <a name="anchor3"></a><br /><hr />  <a name="anchor3"></a><br /><hr />
572  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
573  <a name="rfc.section.4"></a><h3>4.&nbsp;Focus of this protocol</h3>  <a name="rfc.section.4"></a><h3>4.&nbsp;
574    Focus of this protocol</h3>
575    
576  <p>Main focus of this protocol is to provide a way to configure  <p>Main focus of this protocol is to provide a way to configure
577              a running LinuxSampler instance and to retrieve information              a running LinuxSampler instance and to retrieve information
# Line 497  Intellectual Property and Copyright Stat Line 582  Intellectual Property and Copyright Stat
582              via MIDI System Exclusive Messages.              via MIDI System Exclusive Messages.
583  </p>  </p>
584  <a name="anchor4"></a><br /><hr />  <a name="anchor4"></a><br /><hr />
585  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
586  <a name="rfc.section.5"></a><h3>5.&nbsp;Communication Overview</h3>  <a name="rfc.section.5"></a><h3>5.&nbsp;
587    Communication Overview</h3>
588    
589  <p>There are two distinct methods of communication between a  <p>There are two distinct methods of communication between a
590              running instance of LinuxSampler and one or more control              running instance of LinuxSampler and one or more control
# Line 511  Intellectual Property and Copyright Stat Line 597  Intellectual Property and Copyright Stat
597              implemented in the front-end application. The two communication              implemented in the front-end application. The two communication
598              methods will be described next.              methods will be described next.
599  </p>  </p>
600  <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 />
601    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
602    <a name="rfc.section.5.1"></a><h3>5.1.&nbsp;
603    Request/response communication method</h3>
604    
605  <p>This simple communication method is based on  <p>This simple communication method is based on
606                  <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
607                  front-end application establishes a TCP connection to the                  front-end application establishes a TCP connection to the
608                  LinuxSampler instance on a certain host system. Then the                  LinuxSampler instance on a certain host system. Then the
609                  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 643  Intellectual Property and Copyright Stat
643                  processed in the order they were received and result sets                  processed in the order they were received and result sets
644                  MUST be sent back in the same order.                  MUST be sent back in the same order.
645  </p>  </p>
646  <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 />
647    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
648    <a name="rfc.section.5.1.1"></a><h3>5.1.1.&nbsp;
649    Result format</h3>
650    
651  <p>Result set could be one of the following types:  <p>Result set could be one of the following types:
652  </p>  </p>
# Line 568  Intellectual Property and Copyright Stat Line 660  Intellectual Property and Copyright Stat
660  <li>Error  <li>Error
661  </li>  </li>
662  </ol><p>  </ol><p>
663                        
664  </p>  </p>
665  <p>Warning and Error result sets MUST be single line and  <p>Warning and Error result sets MUST be single line and
666                      have the following format:                      have the following format:
# Line 581  Intellectual Property and Copyright Stat Line 673  Intellectual Property and Copyright Stat
673  <li>"ERR:&lt;error-code&gt;:&lt;error-message&gt;"  <li>"ERR:&lt;error-code&gt;:&lt;error-message&gt;"
674  </li>  </li>
675  </ul><p>  </ul><p>
676                        
677  </p>  </p>
678  <p>Where &lt;warning-code&gt; and &lt;error-code&gt; are  <p>Where &lt;warning-code&gt; and &lt;error-code&gt; are
679                      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 691  Intellectual Property and Copyright Stat
691  <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."
692  </p>  </p>
693  </blockquote><p>  </blockquote><p>
694                        
695  </p>  </p>
696  <p>  <p>
697                          </p>                          </p>
# Line 609  Intellectual Property and Copyright Stat Line 701  Intellectual Property and Copyright Stat
701  <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'."
702  </p>  </p>
703  </blockquote><p>  </blockquote><p>
704                        
705  </p>  </p>
706  <p>  <p>
707                          </p>                          </p>
# Line 619  Intellectual Property and Copyright Stat Line 711  Intellectual Property and Copyright Stat
711  <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."
712  </p>  </p>
713  </blockquote><p>  </blockquote><p>
714                        
715  </p>  </p>
716  <p>Normal result sets could be:  <p>Normal result sets could be:
717  </p>  </p>
# Line 633  Intellectual Property and Copyright Stat Line 725  Intellectual Property and Copyright Stat
725  <li>Multi-line  <li>Multi-line
726  </li>  </li>
727  </ol><p>  </ol><p>
728                        
729  </p>  </p>
730  <p> Empty result set is issued when the server only  <p> Empty result set is issued when the server only
731                      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 739  Intellectual Property and Copyright Stat
739  <p>"OK"  <p>"OK"
740  </p>  </p>
741  </blockquote><p>  </blockquote><p>
742                        
743  </p>  </p>
744  <p>Example:  <p>Example:
745  </p>  </p>
# Line 659  Intellectual Property and Copyright Stat Line 751  Intellectual Property and Copyright Stat
751  <p>S: "OK"  <p>S: "OK"
752  </p>  </p>
753  </blockquote><p>  </blockquote><p>
754                        
755  </p>  </p>
756  <p>Single line result sets are command specific. One  <p>Single line result sets are command specific. One
757                      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 765  Intellectual Property and Copyright Stat
765  <p>"."  <p>"."
766  </p>  </p>
767  </blockquote><p>  </blockquote><p>
768                        
769  </p>  </p>
770  <p>Example:  <p>Example:
771  </p>  </p>
# Line 699  Intellectual Property and Copyright Stat Line 791  Intellectual Property and Copyright Stat
791  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
792  </p>  </p>
793  </blockquote><p>  </blockquote><p>
794                        
795  </p>  </p>
796  <p>In addition to above mentioned formats, warnings and  <p>In addition to above mentioned formats, warnings and
797                      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 805  Intellectual Property and Copyright Stat
805  <li>"OK[&lt;index&gt;]"  <li>"OK[&lt;index&gt;]"
806  </li>  </li>
807  </ul><p>  </ul><p>
808                        
809  </p>  </p>
810  <p>where &lt;index&gt; is command specific and is used  <p>where &lt;index&gt; is command specific and is used
811                      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 824  Intellectual Property and Copyright Stat
824  <p>S: "OK[12]"  <p>S: "OK[12]"
825  </p>  </p>
826  </blockquote><p>  </blockquote><p>
827                        
828  </p>  </p>
829  <p>  <p>
830                          </p>                          </p>
# Line 742  Intellectual Property and Copyright Stat Line 834  Intellectual Property and Copyright Stat
834  <p>S: "WRN[0]:32:Sample rate not supported, using 44100 instead."  <p>S: "WRN[0]:32:Sample rate not supported, using 44100 instead."
835  </p>  </p>
836  </blockquote><p>  </blockquote><p>
837                        
838  </p>  </p>
839  <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 />
840    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
841    <a name="rfc.section.5.2"></a><h3>5.2.&nbsp;
842    Subscribe/notify communication method</h3>
843    
844  <p>This more sophisticated communication method is actually  <p>This more sophisticated communication method is actually
845                  only an extension of the simple request/response                  only an extension of the simple request/response
# Line 762  Intellectual Property and Copyright Stat Line 857  Intellectual Property and Copyright Stat
857  <p>SUBSCRIBE &lt;event-id&gt;  <p>SUBSCRIBE &lt;event-id&gt;
858  </p>  </p>
859  </blockquote><p>  </blockquote><p>
860                    
861  </p>  </p>
862  <p>where &lt;event-id&gt; will be replaced by the respective  <p>where &lt;event-id&gt; will be replaced by the respective
863                  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 874  Intellectual Property and Copyright Stat
874  <p>NOTIFY:&lt;event-id&gt;:&lt;custom-event-data&gt;  <p>NOTIFY:&lt;event-id&gt;:&lt;custom-event-data&gt;
875  </p>  </p>
876  </blockquote><p>  </blockquote><p>
877                    
878  </p>  </p>
879  <p>where &lt;event-id&gt; uniquely identifies the event that  <p>where &lt;event-id&gt; uniquely identifies the event that
880                  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 900  Intellectual Property and Copyright Stat
900                          response.                          response.
901  </li>  </li>
902  </ol><p>  </ol><p>
903                    
904  </p>  </p>
905  <p>If the client is not interested in a particular event  <p>If the client is not interested in a particular event
906                  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 912  Intellectual Property and Copyright Stat
912  <p>UNSUBSCRIBE &lt;event-id&gt;  <p>UNSUBSCRIBE &lt;event-id&gt;
913  </p>  </p>
914  </blockquote><p>  </blockquote><p>
915                    
916  </p>  </p>
917  <p>where &lt;event-id&gt; will be replace by the respective  <p>where &lt;event-id&gt; will be replace by the respective
918                  event that client is no longer interested in receiving. For                  event that client is no longer interested in receiving. For
919                  a list of supported events see <a class="info" href="#events">Section&nbsp;8<span> (</span><span class="info">Events</span><span>)</span></a>.                  a list of supported events see <a class='info' href='#events'>Section&nbsp;8<span> (</span><span class='info'>Events</span><span>)</span></a>.
920  </p>  </p>
921  <p>Example: the fill states of disk stream buffers have  <p>Example: the fill states of disk stream buffers have
922                  changed on sampler channel 4 and the LinuxSampler instance                  changed on sampler channel 4 and the LinuxSampler instance
# Line 834  Intellectual Property and Copyright Stat Line 929  Intellectual Property and Copyright Stat
929  <p>NOTIFY:CHANNEL_BUFFER_FILL:4 [35]62%,[33]80%,[37]98%  <p>NOTIFY:CHANNEL_BUFFER_FILL:4 [35]62%,[33]80%,[37]98%
930  </p>  </p>
931  </blockquote><p>  </blockquote><p>
932                    
933  </p>  </p>
934  <p>Which means there are currently three active streams on  <p>Which means there are currently three active streams on
935                  sampler channel 4, where the stream with ID "35" is filled                  sampler channel 4, where the stream with ID "35" is filled
# Line 867  Intellectual Property and Copyright Stat Line 962  Intellectual Property and Copyright Stat
962                  it wants to receive.                  it wants to receive.
963  </p>  </p>
964  <a name="control_commands"></a><br /><hr />  <a name="control_commands"></a><br /><hr />
965  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
966  <a name="rfc.section.6"></a><h3>6.&nbsp;Description for control commands</h3>  <a name="rfc.section.6"></a><h3>6.&nbsp;
967    Description for control commands</h3>
968    
969  <p>This chapter will describe the available control commands  <p>This chapter will describe the available control commands
970              that can be sent on the TCP connection in detail. Some certain              that can be sent on the TCP connection in detail. Some certain
971              commands (e.g. <a class="info" href="#GET CHANNEL INFO">"GET CHANNEL INFO"<span> (</span><span class="info">Getting sampler channel information</span><span>)</span></a>              commands (e.g. <a class='info' href='#GET CHANNEL INFO'>"GET CHANNEL INFO"<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a>
972              or <a class="info" href="#GET ENGINE INFO">"GET ENGINE INFO"<span> (</span><span class="info">Getting information about an engine</span><span>)</span></a>) lead to              or <a class='info' href='#GET ENGINE INFO'>"GET ENGINE INFO"<span> (</span><span class='info'>Getting information about an engine</span><span>)</span></a>) lead to
973              multiple-line responses. In this case LinuxSampler signals the              multiple-line responses. In this case LinuxSampler signals the
974              end of the response by a "." (single dot) line.              end of the response by a "." (single dot) line.
975  </p>  </p>
976  <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 />
977    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
978    <a name="rfc.section.6.1"></a><h3>6.1.&nbsp;
979    Ignored lines and comments</h3>
980    
981  <p>White lines, that is lines which only contain space and  <p>White lines, that is lines which only contain space and
982                  tabulator characters, and lines that start with a "#"                  tabulator characters, and lines that start with a "#"
# Line 885  Intellectual Property and Copyright Stat Line 984  Intellectual Property and Copyright Stat
984                  group commands and to place comments in a LSCP script                  group commands and to place comments in a LSCP script
985                  file.                  file.
986  </p>  </p>
987  <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 />
988    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
989    <a name="rfc.section.6.2"></a><h3>6.2.&nbsp;
990    Configuring audio drivers</h3>
991    
992  <p>Instances of drivers in LinuxSampler are called devices.  <p>Instances of drivers in LinuxSampler are called devices.
993                  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 1020  Intellectual Property and Copyright Stat
1020                  what parameters drivers are offering, how to retrieve their                  what parameters drivers are offering, how to retrieve their
1021                  possible values, etc.                  possible values, etc.
1022  </p>  </p>
1023  <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 />
1024    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1025    <a name="rfc.section.6.2.1"></a><h3>6.2.1.&nbsp;
1026    Getting amount of available audio output drivers</h3>
1027    
1028  <p>Use the following command to get the number of  <p>Use the following command to get the number of
1029                      audio output drivers currently available for the                      audio output drivers currently available for the
# Line 930  Intellectual Property and Copyright Stat Line 1035  Intellectual Property and Copyright Stat
1035  <p>GET AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>GET AVAILABLE_AUDIO_OUTPUT_DRIVERS
1036  </p>  </p>
1037  </blockquote><p>  </blockquote><p>
1038                        
1039  </p>  </p>
1040  <p>Possible Answers:  <p>Possible Answers:
1041  </p>  </p>
# Line 941  Intellectual Property and Copyright Stat Line 1046  Intellectual Property and Copyright Stat
1046                              number of audio output drivers.                              number of audio output drivers.
1047  </p>  </p>
1048  </blockquote><p>  </blockquote><p>
1049                        
1050  </p>  </p>
1051  <p>Example:  <p>Example:
1052  </p>  </p>
# Line 953  Intellectual Property and Copyright Stat Line 1058  Intellectual Property and Copyright Stat
1058  <p>S: "2"  <p>S: "2"
1059  </p>  </p>
1060  </blockquote><p>  </blockquote><p>
1061                        
1062  </p>  </p>
1063  <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 />
1064    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1065    <a name="rfc.section.6.2.2"></a><h3>6.2.2.&nbsp;
1066    Getting all available audio output drivers</h3>
1067    
1068  <p>Use the following command to list all audio output  <p>Use the following command to list all audio output
1069                      drivers currently available for the LinuxSampler                      drivers currently available for the LinuxSampler
# Line 967  Intellectual Property and Copyright Stat Line 1075  Intellectual Property and Copyright Stat
1075  <p>LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS
1076  </p>  </p>
1077  </blockquote><p>  </blockquote><p>
1078                        
1079  </p>  </p>
1080  <p>Possible Answers:  <p>Possible Answers:
1081  </p>  </p>
# Line 979  Intellectual Property and Copyright Stat Line 1087  Intellectual Property and Copyright Stat
1087                              audio output driver.                              audio output driver.
1088  </p>  </p>
1089  </blockquote><p>  </blockquote><p>
1090                        
1091  </p>  </p>
1092  <p>Example:  <p>Example:
1093  </p>  </p>
# Line 991  Intellectual Property and Copyright Stat Line 1099  Intellectual Property and Copyright Stat
1099  <p>S: "ALSA,JACK"  <p>S: "ALSA,JACK"
1100  </p>  </p>
1101  </blockquote><p>  </blockquote><p>
1102                        
1103  </p>  </p>
1104  <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 />
1105                  output driver</h4>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1106    <a name="rfc.section.6.2.3"></a><h3>6.2.3.&nbsp;
1107    Getting information about a specific audio
1108                    output driver</h3>
1109    
1110  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
1111                      about a specific audio output driver:                      about a specific audio output driver:
# Line 1006  Intellectual Property and Copyright Stat Line 1117  Intellectual Property and Copyright Stat
1117                               &lt;audio-output-driver&gt;                               &lt;audio-output-driver&gt;
1118  </p>  </p>
1119  </blockquote><p>  </blockquote><p>
1120                        
1121  </p>  </p>
1122  <p>Where &lt;audio-output-driver&gt; is the name of the  <p>Where &lt;audio-output-driver&gt; is the name of the
1123                      audio output driver, returned by the                      audio output driver, returned by the
1124                      <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.                      <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.
1125  </p>  </p>
1126  <p>Possible Answers:  <p>Possible Answers:
1127  </p>  </p>
# Line 1035  Intellectual Property and Copyright Stat Line 1146  Intellectual Property and Copyright Stat
1146  <p> character string describing the  <p> character string describing the
1147                                        audio output driver                                        audio output driver
1148  </p>  </p>
1149  </blockquote><p>  </blockquote>
1150                                      
1151    
 </p>  
1152  <p>VERSION -  <p>VERSION -
1153                                      </p>                                      </p>
1154  <blockquote class="text">  <blockquote class="text">
1155  <p>character string reflecting the  <p>character string reflecting the
1156                                        driver's version                                        driver's version
1157  </p>  </p>
1158  </blockquote><p>  </blockquote>
1159                                      
1160    
 </p>  
1161  <p>PARAMETERS -  <p>PARAMETERS -
1162                                      </p>                                      </p>
1163  <blockquote class="text">  <blockquote class="text">
# Line 1057  Intellectual Property and Copyright Stat Line 1168  Intellectual Property and Copyright Stat
1168                                        and 'active' are offered by all audio                                        and 'active' are offered by all audio
1169                                        output drivers                                        output drivers
1170  </p>  </p>
1171  </blockquote><p>  </blockquote>
1172                                      
1173    
1174  </p>  </blockquote>
1175  </blockquote><p>                              
1176    
 </p>  
1177  <p>The mentioned fields above don't have to be  <p>The mentioned fields above don't have to be
1178                              in particular order.                              in particular order.
1179  </p>  </p>
1180  </blockquote><p>  </blockquote><p>
1181                        
1182  </p>  </p>
1183  <p>Example:  <p>Example:
1184  </p>  </p>
# Line 1088  Intellectual Property and Copyright Stat Line 1199  Intellectual Property and Copyright Stat
1199  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1200  </p>  </p>
1201  </blockquote><p>  </blockquote><p>
1202                        
1203  </p>  </p>
1204  <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 />
1205                  output driver parameter</h4>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1206    <a name="rfc.section.6.2.4"></a><h3>6.2.4.&nbsp;
1207    Getting information about specific audio
1208                    output driver parameter</h3>
1209    
1210  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
1211                      about a  specific audio output driver parameter:                      about a  specific audio output driver parameter:
# Line 1102  Intellectual Property and Copyright Stat Line 1216  Intellectual Property and Copyright Stat
1216  <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;]
1217  </p>  </p>
1218  </blockquote><p>  </blockquote><p>
1219                        
1220  </p>  </p>
1221  <p>Where &lt;audio&gt; is the name of the audio output  <p>Where &lt;audio&gt; is the name of the audio output
1222                      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,
1223                      &lt;prm&gt; a specific parameter name for which information should be                      &lt;prm&gt; a specific parameter name for which information should be
1224                      obtained (as returned by the                      obtained (as returned by the
1225                      <a class="info" href="#GET AUDIO_OUTPUT_DRIVER INFO">"GET AUDIO_OUTPUT_DRIVER INFO"<span> (</span><span class="info">Getting information about a specific audio                 output driver</span><span>)</span></a> command) and                      <a class='info' href='#GET AUDIO_OUTPUT_DRIVER INFO'>"GET AUDIO_OUTPUT_DRIVER INFO"<span> (</span><span class='info'>Getting information about a specific audio                 output driver</span><span>)</span></a> command) and
1226                      &lt;deplist&gt; is an optional list of parameters on which the sought                      &lt;deplist&gt; is an optional list of parameters on which the sought
1227                      parameter &lt;prm&gt; depends on, &lt;deplist&gt; is a list of key-value                      parameter &lt;prm&gt; depends on, &lt;deplist&gt; is a list of key-value
1228                      pairs in form of "key1=val1 key2=val2 ...", where character string values                      pairs in form of "key1=val1 key2=val2 ...", where character string values
# Line 1134  Intellectual Property and Copyright Stat Line 1248  Intellectual Property and Copyright Stat
1248                              the moment the following information categories are defined:                              the moment the following information categories are defined:
1249  </p>  </p>
1250  </blockquote><p>  </blockquote><p>
1251                        
1252  </p>  </p>
1253  <p>  <p>
1254                          </p>                          </p>
# Line 1148  Intellectual Property and Copyright Stat Line 1262  Intellectual Property and Copyright Stat
1262                                  character string(s)                                  character string(s)
1263                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
1264  </p>  </p>
1265  </blockquote><p>  </blockquote>
1266                                
1267    
 </p>  
1268  <p>DESCRIPTION -  <p>DESCRIPTION -
1269                                </p>                                </p>
1270  <blockquote class="text">  <blockquote class="text">
1271  <p>arbitrary text describing the purpose of the parameter  <p>arbitrary text describing the purpose of the parameter
1272                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
1273  </p>  </p>
1274  </blockquote><p>  </blockquote>
1275                                
1276    
 </p>  
1277  <p>MANDATORY -  <p>MANDATORY -
1278                                </p>                                </p>
1279  <blockquote class="text">  <blockquote class="text">
1280  <p>either true or false, defines if this parameter must be  <p>either true or false, defines if this parameter must be
1281                                  given when the device is to be created with the                                  given when the device is to be created with the
1282                                  <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>
1283                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1284  </p>  </p>
1285  </blockquote><p>  </blockquote>
1286                                
1287    
 </p>  
1288  <p>FIX -  <p>FIX -
1289                                </p>                                </p>
1290  <blockquote class="text">  <blockquote class="text">
1291  <p>either true or false, if false then this parameter can  <p>either true or false, if false then this parameter can
1292                                  be changed at any time, once the device is created by                                  be changed at any time, once the device is created by
1293                                  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>
1294                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1295  </p>  </p>
1296  </blockquote><p>  </blockquote>
1297                                
1298    
 </p>  
1299  <p>MULTIPLICITY -  <p>MULTIPLICITY -
1300                                </p>                                </p>
1301  <blockquote class="text">  <blockquote class="text">
# Line 1190  Intellectual Property and Copyright Stat Line 1304  Intellectual Property and Copyright Stat
1304                                  multiple values and false only a single value allowed                                  multiple values and false only a single value allowed
1305                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
1306  </p>  </p>
1307  </blockquote><p>  </blockquote>
1308                                
1309    
 </p>  
1310  <p>DEPENDS -  <p>DEPENDS -
1311                                </p>                                </p>
1312  <blockquote class="text">  <blockquote class="text">
# Line 1207  Intellectual Property and Copyright Stat Line 1321  Intellectual Property and Copyright Stat
1321                                  chosen by the 'card' parameter                                  chosen by the 'card' parameter
1322                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1323  </p>  </p>
1324  </blockquote><p>  </blockquote>
1325                                
1326    
 </p>  
1327  <p>DEFAULT -  <p>DEFAULT -
1328                                </p>                                </p>
1329  <blockquote class="text">  <blockquote class="text">
1330  <p>reflects the default value for this parameter which is  <p>reflects the default value for this parameter which is
1331                                  used when the device is created and not explicitly                                  used when the device is created and not explicitly
1332                                  given with 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> command,                                  given with 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> command,
1333                                  in case of MULTIPLCITY=true, this is a comma separated                                  in case of MULTIPLCITY=true, this is a comma separated
1334                                  list, that's why character strings are encapsulated into                                  list, that's why character strings are encapsulated into
1335                                  apostrophes (')                                  apostrophes (')
1336                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1337  </p>  </p>
1338  </blockquote><p>  </blockquote>
1339                                
1340    
 </p>  
1341  <p>RANGE_MIN -  <p>RANGE_MIN -
1342                                </p>                                </p>
1343  <blockquote class="text">  <blockquote class="text">
# Line 1233  Intellectual Property and Copyright Stat Line 1347  Intellectual Property and Copyright Stat
1347                                  with RANGE_MAX, but may also appear without                                  with RANGE_MAX, but may also appear without
1348                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1349  </p>  </p>
1350  </blockquote><p>  </blockquote>
1351                                
1352    
 </p>  
1353  <p>RANGE_MAX -  <p>RANGE_MAX -
1354                                </p>                                </p>
1355  <blockquote class="text">  <blockquote class="text">
# Line 1245  Intellectual Property and Copyright Stat Line 1359  Intellectual Property and Copyright Stat
1359                                  RANGE_MIN, but may also appear without                                  RANGE_MIN, but may also appear without
1360                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1361  </p>  </p>
1362  </blockquote><p>  </blockquote>
1363                                
1364    
 </p>  
1365  <p>POSSIBILITIES -  <p>POSSIBILITIES -
1366                                </p>                                </p>
1367  <blockquote class="text">  <blockquote class="text">
# Line 1256  Intellectual Property and Copyright Stat Line 1370  Intellectual Property and Copyright Stat
1370                                  apostrophes                                  apostrophes
1371                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1372  </p>  </p>
1373  </blockquote><p>  </blockquote>
1374                                
1375    
 </p>  
1376  </blockquote><p>  </blockquote><p>
1377                        
1378  </p>  </p>
1379  <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.
1380  </p>  </p>
# Line 1288  Intellectual Property and Copyright Stat Line 1402  Intellectual Property and Copyright Stat
1402  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1403  </p>  </p>
1404  </blockquote><p>  </blockquote><p>
1405                        
1406  </p>  </p>
1407  <p>  <p>
1408                          </p>                          </p>
# Line 1312  Intellectual Property and Copyright Stat Line 1426  Intellectual Property and Copyright Stat
1426  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1427  </p>  </p>
1428  </blockquote><p>  </blockquote><p>
1429                        
1430  </p>  </p>
1431  <p>  <p>
1432                          </p>                          </p>
# Line 1340  Intellectual Property and Copyright Stat Line 1454  Intellectual Property and Copyright Stat
1454  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1455  </p>  </p>
1456  </blockquote><p>  </blockquote><p>
1457                        
1458  </p>  </p>
1459  <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 />
1460    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1461    <a name="rfc.section.6.2.5"></a><h3>6.2.5.&nbsp;
1462    Creating an audio output device</h3>
1463    
1464  <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:
1465  </p>  </p>
# Line 1352  Intellectual Property and Copyright Stat Line 1469  Intellectual Property and Copyright Stat
1469  <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;]
1470  </p>  </p>
1471  </blockquote><p>  </blockquote><p>
1472                        
1473  </p>  </p>
1474  <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
1475                      output system as returned by the                      output system as returned by the
1476                      <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>
1477                      command and &lt;param-list&gt; by an optional list of driver                      command and &lt;param-list&gt; by an optional list of driver
1478                      specific parameters in form of "key1=val1 key2=val2 ...", where                      specific parameters in form of "key1=val1 key2=val2 ...", where
1479                      character string values should be encapsulated into apostrophes (').                      character string values should be encapsulated into apostrophes (').
# Line 1375  Intellectual Property and Copyright Stat Line 1492  Intellectual Property and Copyright Stat
1492  <p>in case the device was successfully created, where  <p>in case the device was successfully created, where
1493                                      &lt;device-id&gt; is the numerical ID of the new device                                      &lt;device-id&gt; is the numerical ID of the new device
1494  </p>  </p>
1495  </blockquote><p>  </blockquote>
1496                                
1497    
 </p>  
1498  <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;" -
1499                                  </p>                                  </p>
1500  <blockquote class="text">  <blockquote class="text">
# Line 1388  Intellectual Property and Copyright Stat Line 1505  Intellectual Property and Copyright Stat
1505                                      fall-back values), providing an appropriate warning code and                                      fall-back values), providing an appropriate warning code and
1506                                      warning message                                      warning message
1507  </p>  </p>
1508  </blockquote><p>  </blockquote>
1509                                
1510    
 </p>  
1511  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
1512                                  </p>                                  </p>
1513  <blockquote class="text">  <blockquote class="text">
1514  <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
1515  </p>  </p>
1516  </blockquote><p>  </blockquote>
1517                                
1518    
 </p>  
1519  </blockquote><p>  </blockquote><p>
1520                        
1521  </p>  </p>
1522  <p>Examples:  <p>Examples:
1523  </p>  </p>
# Line 1412  Intellectual Property and Copyright Stat Line 1529  Intellectual Property and Copyright Stat
1529  <p>S: "OK[0]"  <p>S: "OK[0]"
1530  </p>  </p>
1531  </blockquote><p>  </blockquote><p>
1532                        
1533  </p>  </p>
1534  <p>  <p>
1535                          </p>                          </p>
# Line 1422  Intellectual Property and Copyright Stat Line 1539  Intellectual Property and Copyright Stat
1539  <p>S: "OK[1]"  <p>S: "OK[1]"
1540  </p>  </p>
1541  </blockquote><p>  </blockquote><p>
1542                        
1543  </p>  </p>
1544  <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 />
1545    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1546    <a name="rfc.section.6.2.6"></a><h3>6.2.6.&nbsp;
1547    Destroying an audio output device</h3>
1548    
1549  <p>Use the following command to destroy a created output device:  <p>Use the following command to destroy a created output device:
1550  </p>  </p>
# Line 1434  Intellectual Property and Copyright Stat Line 1554  Intellectual Property and Copyright Stat
1554  <p>DESTROY AUDIO_OUTPUT_DEVICE &lt;device-id&gt;  <p>DESTROY AUDIO_OUTPUT_DEVICE &lt;device-id&gt;
1555  </p>  </p>
1556  </blockquote><p>  </blockquote><p>
1557                        
1558  </p>  </p>
1559  <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
1560                      audio output device as given by the                      audio output device as given by the
1561                      <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>
1562                      or <a class="info" href="#LIST AUDIO_OUTPUT_DEVICES">"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class="info">Getting all created audio output device list</span><span>)</span></a>                      or <a class='info' href='#LIST AUDIO_OUTPUT_DEVICES'>"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class='info'>Getting all created audio output device list</span><span>)</span></a>
1563                      command.                      command.
1564  </p>  </p>
1565  <p>Possible Answers:  <p>Possible Answers:
# Line 1452  Intellectual Property and Copyright Stat Line 1572  Intellectual Property and Copyright Stat
1572  <blockquote class="text">  <blockquote class="text">
1573  <p>in case the device was successfully destroyed  <p>in case the device was successfully destroyed
1574  </p>  </p>
1575  </blockquote><p>  </blockquote>
1576                                
1577    
 </p>  
1578  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
1579                                  </p>                                  </p>
1580  <blockquote class="text">  <blockquote class="text">
# Line 1464  Intellectual Property and Copyright Stat Line 1584  Intellectual Property and Copyright Stat
1584                                      informed about this situation), providing an appropriate                                      informed about this situation), providing an appropriate
1585                                      warning code and warning message                                      warning code and warning message
1586  </p>  </p>
1587  </blockquote><p>  </blockquote>
1588                                
1589    
 </p>  
1590  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
1591                                  </p>                                  </p>
1592  <blockquote class="text">  <blockquote class="text">
1593  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
1594                                      error message                                      error message
1595  </p>  </p>
1596  </blockquote><p>  </blockquote>
1597                                
1598    
 </p>  
1599  </blockquote><p>  </blockquote><p>
1600                        
1601  </p>  </p>
1602  <p>Example:  <p>Example:
1603  </p>  </p>
# Line 1489  Intellectual Property and Copyright Stat Line 1609  Intellectual Property and Copyright Stat
1609  <p>S: "OK"  <p>S: "OK"
1610  </p>  </p>
1611  </blockquote><p>  </blockquote><p>
1612                        
1613  </p>  </p>
1614  <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 />
1615    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1616    <a name="rfc.section.6.2.7"></a><h3>6.2.7.&nbsp;
1617    Getting all created audio output device count</h3>
1618    
1619  <p>Use the following command to count all created audio output devices:  <p>Use the following command to count all created audio output devices:
1620  </p>  </p>
# Line 1501  Intellectual Property and Copyright Stat Line 1624  Intellectual Property and Copyright Stat
1624  <p>GET AUDIO_OUTPUT_DEVICES  <p>GET AUDIO_OUTPUT_DEVICES
1625  </p>  </p>
1626  </blockquote><p>  </blockquote><p>
1627                        
1628  </p>  </p>
1629  <p>Possible Answers:  <p>Possible Answers:
1630  </p>  </p>
# Line 1512  Intellectual Property and Copyright Stat Line 1635  Intellectual Property and Copyright Stat
1635                              audio output devices.                              audio output devices.
1636  </p>  </p>
1637  </blockquote><p>  </blockquote><p>
1638                        
1639  </p>  </p>
1640  <p>Example:  <p>Example:
1641  </p>  </p>
# Line 1524  Intellectual Property and Copyright Stat Line 1647  Intellectual Property and Copyright Stat
1647  <p>S: "4"  <p>S: "4"
1648  </p>  </p>
1649  </blockquote><p>  </blockquote><p>
1650                        
1651  </p>  </p>
1652  <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 />
1653    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1654    <a name="rfc.section.6.2.8"></a><h3>6.2.8.&nbsp;
1655    Getting all created audio output device list</h3>
1656    
1657  <p>Use the following command to list all created audio output devices:  <p>Use the following command to list all created audio output devices:
1658  </p>  </p>
# Line 1536  Intellectual Property and Copyright Stat Line 1662  Intellectual Property and Copyright Stat
1662  <p>LIST AUDIO_OUTPUT_DEVICES  <p>LIST AUDIO_OUTPUT_DEVICES
1663  </p>  </p>
1664  </blockquote><p>  </blockquote><p>
1665                        
1666  </p>  </p>
1667  <p>Possible Answers:  <p>Possible Answers:
1668  </p>  </p>
# Line 1547  Intellectual Property and Copyright Stat Line 1673  Intellectual Property and Copyright Stat
1673                              the numerical IDs of all audio output devices.                              the numerical IDs of all audio output devices.
1674  </p>  </p>
1675  </blockquote><p>  </blockquote><p>
1676                        
1677  </p>  </p>
1678  <p>Example:  <p>Example:
1679  </p>  </p>
# Line 1559  Intellectual Property and Copyright Stat Line 1685  Intellectual Property and Copyright Stat
1685  <p>S: "0,1,4,5"  <p>S: "0,1,4,5"
1686  </p>  </p>
1687  </blockquote><p>  </blockquote><p>
1688                        
1689  </p>  </p>
1690  <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 />
1691    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1692    <a name="rfc.section.6.2.9"></a><h3>6.2.9.&nbsp;
1693    Getting current settings of an audio output device</h3>
1694    
1695  <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:
1696  </p>  </p>
# Line 1571  Intellectual Property and Copyright Stat Line 1700  Intellectual Property and Copyright Stat
1700  <p>GET AUDIO_OUTPUT_DEVICE INFO &lt;device-id&gt;  <p>GET AUDIO_OUTPUT_DEVICE INFO &lt;device-id&gt;
1701  </p>  </p>
1702  </blockquote><p>  </blockquote><p>
1703                        
1704  </p>  </p>
1705  <p>Where &lt;device-id&gt; should be replaced by numerical ID  <p>Where &lt;device-id&gt; should be replaced by numerical ID
1706                      of the audio output device as e.g. returned by the                      of the audio output device as e.g. returned by the
1707                      <a class="info" href="#LIST AUDIO_OUTPUT_DEVICES">"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class="info">Getting all created audio output device list</span><span>)</span></a> command.                      <a class='info' href='#LIST AUDIO_OUTPUT_DEVICES'>"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class='info'>Getting all created audio output device list</span><span>)</span></a> command.
1708  </p>  </p>
1709  <p>Possible Answers:  <p>Possible Answers:
1710  </p>  </p>
# Line 1595  Intellectual Property and Copyright Stat Line 1724  Intellectual Property and Copyright Stat
1724  <blockquote class="text">  <blockquote class="text">
1725  <p>identifier of the used audio output driver, as also  <p>identifier of the used audio output driver, as also
1726                                      returned by the                                      returned by the
1727                                      <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>
1728                                      command                                      command
1729  </p>  </p>
1730  </blockquote><p>  </blockquote>
1731                                
1732    
 </p>  
1733  <p>CHANNELS -  <p>CHANNELS -
1734                                  </p>                                  </p>
1735  <blockquote class="text">  <blockquote class="text">
1736  <p>amount of audio output channels this device currently  <p>amount of audio output channels this device currently
1737                                      offers                                      offers
1738  </p>  </p>
1739  </blockquote><p>  </blockquote>
1740                                
1741    
 </p>  
1742  <p>SAMPLERATE -  <p>SAMPLERATE -
1743                                  </p>                                  </p>
1744  <blockquote class="text">  <blockquote class="text">
1745  <p>playback sample rate the device uses  <p>playback sample rate the device uses
1746  </p>  </p>
1747  </blockquote><p>  </blockquote>
1748                                
1749    
 </p>  
1750  <p>ACTIVE -  <p>ACTIVE -
1751                                  </p>                                  </p>
1752  <blockquote class="text">  <blockquote class="text">
# Line 1626  Intellectual Property and Copyright Stat Line 1755  Intellectual Property and Copyright Stat
1755                                      sampler channels connected to this audio device render                                      sampler channels connected to this audio device render
1756                                      any audio                                      any audio
1757  </p>  </p>
1758  </blockquote><p>  </blockquote>
1759                                
1760    
 </p>  
1761  </blockquote><p>  </blockquote><p>
1762                        
1763  </p>  </p>
1764  <p>The mentioned fields above don't have to be in particular  <p>The mentioned fields above don't have to be in particular
1765                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
1766                      returned by all audio output devices. Every audio output driver                      returned by all audio output devices. Every audio output driver
1767                      might have its own, additional driver specific parameters (see                      might have its own, additional driver specific parameters (see
1768                      <a class="info" href="#GET AUDIO_OUTPUT_DRIVER INFO">Section&nbsp;6.2.3<span> (</span><span class="info">Getting information about a specific audio                 output driver</span><span>)</span></a>)                      <a class='info' href='#GET AUDIO_OUTPUT_DRIVER INFO'>Section&nbsp;6.2.3<span> (</span><span class='info'>Getting information about a specific audio                 output driver</span><span>)</span></a>)
1769                      which are also returned by this command.                      which are also returned by this command.
1770  </p>  </p>
1771  <p>Example:  <p>Example:
# Line 1663  Intellectual Property and Copyright Stat Line 1792  Intellectual Property and Copyright Stat
1792  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1793  </p>  </p>
1794  </blockquote><p>  </blockquote><p>
1795                        
1796  </p>  </p>
1797  <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 />
1798    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1799    <a name="rfc.section.6.2.10"></a><h3>6.2.10.&nbsp;
1800    Changing settings of audio output devices</h3>
1801    
1802  <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:
1803  </p>  </p>
# Line 1675  Intellectual Property and Copyright Stat Line 1807  Intellectual Property and Copyright Stat
1807  <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;
1808  </p>  </p>
1809  </blockquote><p>  </blockquote><p>
1810                        
1811  </p>  </p>
1812  <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
1813                      audio output device as given by the                      audio output device as given by the
1814                      <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>
1815                      or <a class="info" href="#LIST AUDIO_OUTPUT_DEVICES">"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class="info">Getting all created audio output device list</span><span>)</span></a>                      or <a class='info' href='#LIST AUDIO_OUTPUT_DEVICES'>"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class='info'>Getting all created audio output device list</span><span>)</span></a>
1816                      command, &lt;key&gt; by the name of the parameter to change                      command, &lt;key&gt; by the name of the parameter to change
1817                      and &lt;value&gt; by the new value for this parameter.                      and &lt;value&gt; by the new value for this parameter.
1818  </p>  </p>
# Line 1694  Intellectual Property and Copyright Stat Line 1826  Intellectual Property and Copyright Stat
1826  <blockquote class="text">  <blockquote class="text">
1827  <p>in case setting was successfully changed  <p>in case setting was successfully changed
1828  </p>  </p>
1829  </blockquote><p>  </blockquote>
1830                                
1831    
 </p>  
1832  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
1833                                  </p>                                  </p>
1834  <blockquote class="text">  <blockquote class="text">
# Line 1704  Intellectual Property and Copyright Stat Line 1836  Intellectual Property and Copyright Stat
1836                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
1837                                      warning code and warning message                                      warning code and warning message
1838  </p>  </p>
1839  </blockquote><p>  </blockquote>
1840                                
1841    
 </p>  
1842  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
1843                                  </p>                                  </p>
1844  <blockquote class="text">  <blockquote class="text">
1845  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
1846                                      error message                                      error message
1847  </p>  </p>
1848  </blockquote><p>  </blockquote>
1849                                
1850    
 </p>  
1851  </blockquote><p>  </blockquote><p>
1852                        
1853  </p>  </p>
1854  <p>Example:  <p>Example:
1855  </p>  </p>
# Line 1729  Intellectual Property and Copyright Stat Line 1861  Intellectual Property and Copyright Stat
1861  <p>S: "OK"  <p>S: "OK"
1862  </p>  </p>
1863  </blockquote><p>  </blockquote><p>
1864                        
1865  </p>  </p>
1866  <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 />
1867    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
1868    <a name="rfc.section.6.2.11"></a><h3>6.2.11.&nbsp;
1869    Getting information about an audio channel</h3>
1870    
1871  <p>Use the following command to get information about an audio channel:  <p>Use the following command to get information about an audio channel:
1872  </p>  </p>
# Line 1741  Intellectual Property and Copyright Stat Line 1876  Intellectual Property and Copyright Stat
1876  <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;
1877  </p>  </p>
1878  </blockquote><p>  </blockquote><p>
1879                        
1880  </p>  </p>
1881  <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
1882                      <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>
1883                      or <a class="info" href="#LIST AUDIO_OUTPUT_DEVICES">"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class="info">Getting all created audio output device list</span><span>)</span></a>                      or <a class='info' href='#LIST AUDIO_OUTPUT_DEVICES'>"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class='info'>Getting all created audio output device list</span><span>)</span></a>
1884                      command and &lt;audio-chan&gt; the audio channel number.                      command and &lt;audio-chan&gt; the audio channel number.
1885  </p>  </p>
1886  <p>Possible Answers:  <p>Possible Answers:
# Line 1768  Intellectual Property and Copyright Stat Line 1903  Intellectual Property and Copyright Stat
1903  <p>arbitrary character string naming the channel, which  <p>arbitrary character string naming the channel, which
1904                                              doesn't have to be unique (always returned by all audio channels)                                              doesn't have to be unique (always returned by all audio channels)
1905  </p>  </p>
1906  </blockquote><p>  </blockquote>
1907                                        
1908    
 </p>  
1909  <p>IS_MIX_CHANNEL -  <p>IS_MIX_CHANNEL -
1910                                          </p>                                          </p>
1911  <blockquote class="text">  <blockquote class="text">
# Line 1781  Intellectual Property and Copyright Stat Line 1916  Intellectual Property and Copyright Stat
1916                                              channels than the used audio system might be able to offer                                              channels than the used audio system might be able to offer
1917                                              (always returned by all audio channels)                                              (always returned by all audio channels)
1918  </p>  </p>
1919  </blockquote><p>  </blockquote>
1920                                        
1921    
 </p>  
1922  <p>MIX_CHANNEL_DESTINATION -  <p>MIX_CHANNEL_DESTINATION -
1923                                          </p>                                          </p>
1924  <blockquote class="text">  <blockquote class="text">
# Line 1793  Intellectual Property and Copyright Stat Line 1928  Intellectual Property and Copyright Stat
1928                                              the audio signal actually will be routed / added to                                              the audio signal actually will be routed / added to
1929                                              (only returned in case the audio channel is mix channel)                                              (only returned in case the audio channel is mix channel)
1930  </p>  </p>
1931  </blockquote><p>  </blockquote>
1932                                        
1933    
1934  </p>  </blockquote>
1935  </blockquote><p>                              
1936    
 </p>  
1937  </blockquote><p>  </blockquote><p>
1938                        
1939  </p>  </p>
1940  <p>The mentioned fields above don't have to be in particular  <p>The mentioned fields above don't have to be in particular
1941                      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 1958  Intellectual Property and Copyright Stat
1958  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1959  </p>  </p>
1960  </blockquote><p>  </blockquote><p>
1961                        
1962  </p>  </p>
1963  <p>  <p>
1964                          </p>                          </p>
# Line 1837  Intellectual Property and Copyright Stat Line 1972  Intellectual Property and Copyright Stat
1972  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1973  </p>  </p>
1974  </blockquote><p>  </blockquote><p>
1975                        
1976  </p>  </p>
1977  <p>  <p>
1978                          </p>                          </p>
# Line 1853  Intellectual Property and Copyright Stat Line 1988  Intellectual Property and Copyright Stat
1988  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1989  </p>  </p>
1990  </blockquote><p>  </blockquote><p>
1991                        
1992  </p>  </p>
1993  <p>  <p>
1994                          </p>                          </p>
# Line 1869  Intellectual Property and Copyright Stat Line 2004  Intellectual Property and Copyright Stat
2004  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2005  </p>  </p>
2006  </blockquote><p>  </blockquote><p>
2007                        
2008  </p>  </p>
2009  <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 />
2010    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2011    <a name="rfc.section.6.2.12"></a><h3>6.2.12.&nbsp;
2012    Getting information about specific audio channel parameter</h3>
2013    
2014  <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:
2015  </p>  </p>
# Line 1881  Intellectual Property and Copyright Stat Line 2019  Intellectual Property and Copyright Stat
2019  <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;
2020  </p>  </p>
2021  </blockquote><p>  </blockquote><p>
2022                        
2023  </p>  </p>
2024  <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
2025                      <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>
2026                      or <a class="info" href="#LIST AUDIO_OUTPUT_DEVICES">"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class="info">Getting all created audio output device list</span><span>)</span></a>                      or <a class='info' href='#LIST AUDIO_OUTPUT_DEVICES'>"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class='info'>Getting all created audio output device list</span><span>)</span></a>
2027                      command, &lt;chan&gt; the audio channel number                      command, &lt;chan&gt; the audio channel number
2028                      and &lt;param&gt; a specific channel parameter name for which information should                      and &lt;param&gt; a specific channel parameter name for which information should
2029                      be obtained (as returned by the <a class="info" href="#GET AUDIO_OUTPUT_CHANNEL INFO">"GET AUDIO_OUTPUT_CHANNEL INFO"<span> (</span><span class="info">Getting information about an audio channel</span><span>)</span></a> command).                      be obtained (as returned by the <a class='info' href='#GET AUDIO_OUTPUT_CHANNEL INFO'>"GET AUDIO_OUTPUT_CHANNEL INFO"<span> (</span><span class='info'>Getting information about an audio channel</span><span>)</span></a> command).
2030  </p>  </p>
2031  <p>Possible Answers:  <p>Possible Answers:
2032  </p>  </p>
# Line 1915  Intellectual Property and Copyright Stat Line 2053  Intellectual Property and Copyright Stat
2053                                              character string(s)                                              character string(s)
2054                                              (always returned)                                              (always returned)
2055  </p>  </p>
2056  </blockquote><p>  </blockquote>
2057                                        
2058    
 </p>  
2059  <p>DESCRIPTION -  <p>DESCRIPTION -
2060                                          </p>                                          </p>
2061  <blockquote class="text">  <blockquote class="text">
2062  <p>arbitrary text describing the purpose of the parameter (always returned)  <p>arbitrary text describing the purpose of the parameter (always returned)
2063  </p>  </p>
2064  </blockquote><p>  </blockquote>
2065                                        
2066    
 </p>  
2067  <p>FIX -  <p>FIX -
2068                                          </p>                                          </p>
2069  <blockquote class="text">  <blockquote class="text">
# Line 1933  Intellectual Property and Copyright Stat Line 2071  Intellectual Property and Copyright Stat
2071                                              read only, thus cannot be altered                                              read only, thus cannot be altered
2072                                              (always returned)                                              (always returned)
2073  </p>  </p>
2074  </blockquote><p>  </blockquote>
2075                                        
2076    
 </p>  
2077  <p>MULTIPLICITY -  <p>MULTIPLICITY -
2078                                          </p>                                          </p>
2079  <blockquote class="text">  <blockquote class="text">
# Line 1944  Intellectual Property and Copyright Stat Line 2082  Intellectual Property and Copyright Stat
2082                                              multiple values and false only a single value allowed                                              multiple values and false only a single value allowed
2083                                              (always returned)                                              (always returned)
2084  </p>  </p>
2085  </blockquote><p>  </blockquote>
2086                                        
2087    
 </p>  
2088  <p>RANGE_MIN -  <p>RANGE_MIN -
2089                                          </p>                                          </p>
2090  <blockquote class="text">  <blockquote class="text">
# Line 1957  Intellectual Property and Copyright Stat Line 2095  Intellectual Property and Copyright Stat
2095                                              (optionally returned, dependent to driver and channel                                              (optionally returned, dependent to driver and channel
2096                                              parameter)                                              parameter)
2097  </p>  </p>
2098  </blockquote><p>  </blockquote>
2099                                        
2100    
 </p>  
2101  <p>RANGE_MAX -  <p>RANGE_MAX -
2102                                          </p>                                          </p>
2103  <blockquote class="text">  <blockquote class="text">
# Line 1970  Intellectual Property and Copyright Stat Line 2108  Intellectual Property and Copyright Stat
2108                                              (optionally returned, dependent to driver and channel                                              (optionally returned, dependent to driver and channel
2109                                              parameter)                                              parameter)
2110  </p>  </p>
2111  </blockquote><p>  </blockquote>
2112                                        
2113    
 </p>  
2114  <p>POSSIBILITIES -  <p>POSSIBILITIES -
2115                                          </p>                                          </p>
2116  <blockquote class="text">  <blockquote class="text">
# Line 1982  Intellectual Property and Copyright Stat Line 2120  Intellectual Property and Copyright Stat
2120                                              (optionally returned, dependent to driver and channel                                              (optionally returned, dependent to driver and channel
2121                                              parameter)                                              parameter)
2122  </p>  </p>
2123  </blockquote><p>  </blockquote>
2124                                        
2125    
2126  </p>  </blockquote>
2127  </blockquote><p>                              
2128    
 </p>  
2129  <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.
2130  </p>  </p>
2131  </blockquote><p>  </blockquote><p>
2132                        
2133  </p>  </p>
2134  <p>Example:  <p>Example:
2135  </p>  </p>
# Line 2013  Intellectual Property and Copyright Stat Line 2151  Intellectual Property and Copyright Stat
2151  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2152  </p>  </p>
2153  </blockquote><p>  </blockquote><p>
2154                        
2155  </p>  </p>
2156  <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 />
2157    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2158    <a name="rfc.section.6.2.13"></a><h3>6.2.13.&nbsp;
2159    Changing settings of audio output channels</h3>
2160    
2161  <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:
2162  </p>  </p>
# Line 2025  Intellectual Property and Copyright Stat Line 2166  Intellectual Property and Copyright Stat
2166  <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;
2167  </p>  </p>
2168  </blockquote><p>  </blockquote><p>
2169                        
2170  </p>  </p>
2171  <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
2172                      <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>
2173                      or <a class="info" href="#LIST AUDIO_OUTPUT_DEVICES">"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class="info">Getting all created audio output device list</span><span>)</span></a>                      or <a class='info' href='#LIST AUDIO_OUTPUT_DEVICES'>"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class='info'>Getting all created audio output device list</span><span>)</span></a>
2174                      command, &lt;chn&gt; by the audio channel number, &lt;key&gt; by the name of the                      command, &lt;chn&gt; by the audio channel number, &lt;key&gt; by the name of the
2175                      parameter to change and &lt;value&gt; by the new value for this parameter.                      parameter to change and &lt;value&gt; by the new value for this parameter.
2176  </p>  </p>
# Line 2043  Intellectual Property and Copyright Stat Line 2184  Intellectual Property and Copyright Stat
2184  <blockquote class="text">  <blockquote class="text">
2185  <p>in case setting was successfully changed  <p>in case setting was successfully changed
2186  </p>  </p>
2187  </blockquote><p>  </blockquote>
2188                                
2189    
 </p>  
2190  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
2191                                  </p>                                  </p>
2192  <blockquote class="text">  <blockquote class="text">
# Line 2053  Intellectual Property and Copyright Stat Line 2194  Intellectual Property and Copyright Stat
2194                                     noteworthy issue(s) related, providing an appropriate                                     noteworthy issue(s) related, providing an appropriate
2195                                     warning code and warning message                                     warning code and warning message
2196  </p>  </p>
2197  </blockquote><p>  </blockquote>
2198                                
2199    
 </p>  
2200  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2201                                  </p>                                  </p>
2202  <blockquote class="text">  <blockquote class="text">
2203  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
2204                                     error message                                     error message
2205  </p>  </p>
2206  </blockquote><p>  </blockquote>
2207                                
2208    
 </p>  
2209  </blockquote><p>  </blockquote><p>
2210                        
2211  </p>  </p>
2212  <p>Example:  <p>Example:
2213  </p>  </p>
# Line 2078  Intellectual Property and Copyright Stat Line 2219  Intellectual Property and Copyright Stat
2219  <p>S: "OK"  <p>S: "OK"
2220  </p>  </p>
2221  </blockquote><p>  </blockquote><p>
2222                        
2223  </p>  </p>
2224  <p>  <p>
2225                          </p>                          </p>
# Line 2088  Intellectual Property and Copyright Stat Line 2229  Intellectual Property and Copyright Stat
2229  <p>S: "OK"  <p>S: "OK"
2230  </p>  </p>
2231  </blockquote><p>  </blockquote><p>
2232                        
2233  </p>  </p>
2234  <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 />
2235    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2236    <a name="rfc.section.6.3"></a><h3>6.3.&nbsp;
2237    Configuring MIDI input drivers</h3>
2238    
2239  <p>Instances of drivers in LinuxSampler are called devices. You can use  <p>Instances of drivers in LinuxSampler are called devices. You can use
2240                  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 2262  Intellectual Property and Copyright Stat
2262                  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
2263                  possible values, etc.                  possible values, etc.
2264  </p>  </p>
2265  <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 />
2266    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2267    <a name="rfc.section.6.3.1"></a><h3>6.3.1.&nbsp;
2268    Getting amount of available MIDI input drivers</h3>
2269    
2270  <p>Use the following command to get the number of  <p>Use the following command to get the number of
2271                      MIDI input drivers currently available for the                      MIDI input drivers currently available for the
# Line 2130  Intellectual Property and Copyright Stat Line 2277  Intellectual Property and Copyright Stat
2277  <p>GET AVAILABLE_MIDI_INPUT_DRIVERS  <p>GET AVAILABLE_MIDI_INPUT_DRIVERS
2278  </p>  </p>
2279  </blockquote><p>  </blockquote><p>
2280                        
2281  </p>  </p>
2282  <p>Possible Answers:  <p>Possible Answers:
2283  </p>  </p>
# Line 2141  Intellectual Property and Copyright Stat Line 2288  Intellectual Property and Copyright Stat
2288                              number of available MIDI input drivers.                              number of available MIDI input drivers.
2289  </p>  </p>
2290  </blockquote><p>  </blockquote><p>
2291                        
2292  </p>  </p>
2293  <p>Example:  <p>Example:
2294  </p>  </p>
# Line 2153  Intellectual Property and Copyright Stat Line 2300  Intellectual Property and Copyright Stat
2300  <p>S: "2"  <p>S: "2"
2301  </p>  </p>
2302  </blockquote><p>  </blockquote><p>
2303                        
2304  </p>  </p>
2305  <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 />
2306    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2307    <a name="rfc.section.6.3.2"></a><h3>6.3.2.&nbsp;
2308    Getting all available MIDI input drivers</h3>
2309    
2310  <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
2311                      for the LinuxSampler instance:                      for the LinuxSampler instance:
# Line 2166  Intellectual Property and Copyright Stat Line 2316  Intellectual Property and Copyright Stat
2316  <p>LIST AVAILABLE_MIDI_INPUT_DRIVERS  <p>LIST AVAILABLE_MIDI_INPUT_DRIVERS
2317  </p>  </p>
2318  </blockquote><p>  </blockquote><p>
2319                        
2320  </p>  </p>
2321  <p>Possible Answers:  <p>Possible Answers:
2322  </p>  </p>
# Line 2177  Intellectual Property and Copyright Stat Line 2327  Intellectual Property and Copyright Stat
2327                              strings, each symbolizing a MIDI input driver.                              strings, each symbolizing a MIDI input driver.
2328  </p>  </p>
2329  </blockquote><p>  </blockquote><p>
2330                        
2331  </p>  </p>
2332  <p>Example:  <p>Example:
2333  </p>  </p>
# Line 2189  Intellectual Property and Copyright Stat Line 2339  Intellectual Property and Copyright Stat
2339  <p>S: "ALSA,JACK"  <p>S: "ALSA,JACK"
2340  </p>  </p>
2341  </blockquote><p>  </blockquote><p>
2342                        
2343  </p>  </p>
2344  <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 />
2345    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2346    <a name="rfc.section.6.3.3"></a><h3>6.3.3.&nbsp;
2347    Getting information about a specific MIDI input driver</h3>
2348    
2349  <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:
2350  </p>  </p>
# Line 2201  Intellectual Property and Copyright Stat Line 2354  Intellectual Property and Copyright Stat
2354  <p>GET MIDI_INPUT_DRIVER INFO &lt;midi-input-driver&gt;  <p>GET MIDI_INPUT_DRIVER INFO &lt;midi-input-driver&gt;
2355  </p>  </p>
2356  </blockquote><p>  </blockquote><p>
2357                        
2358  </p>  </p>
2359  <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
2360                      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.
2361  </p>  </p>
2362  <p>Possible Answers:  <p>Possible Answers:
2363  </p>  </p>
# Line 2225  Intellectual Property and Copyright Stat Line 2378  Intellectual Property and Copyright Stat
2378  <blockquote class="text">  <blockquote class="text">
2379  <p>arbitrary description text about the MIDI input driver  <p>arbitrary description text about the MIDI input driver
2380  </p>  </p>
2381  </blockquote><p>  </blockquote>
2382                                        
2383    
 </p>  
2384  <p>VERSION -  <p>VERSION -
2385                                          </p>                                          </p>
2386  <blockquote class="text">  <blockquote class="text">
2387  <p>arbitrary character string regarding the driver's version  <p>arbitrary character string regarding the driver's version
2388  </p>  </p>
2389  </blockquote><p>  </blockquote>
2390                                        
2391    
 </p>  
2392  <p>PARAMETERS -  <p>PARAMETERS -
2393                                          </p>                                          </p>
2394  <blockquote class="text">  <blockquote class="text">
2395  <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
2396  </p>  </p>
2397  </blockquote><p>  </blockquote>
2398                                        
2399    
2400  </p>  </blockquote>
2401  </blockquote><p>                              
2402    
 </p>  
2403  <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.
2404  </p>  </p>
2405  </blockquote><p>  </blockquote><p>
2406                        
2407  </p>  </p>
2408  <p>Example:  <p>Example:
2409  </p>  </p>
# Line 2268  Intellectual Property and Copyright Stat Line 2421  Intellectual Property and Copyright Stat
2421  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2422  </p>  </p>
2423  </blockquote><p>  </blockquote><p>
2424                        
2425  </p>  </p>
2426  <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 />
2427    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2428    <a name="rfc.section.6.3.4"></a><h3>6.3.4.&nbsp;
2429    Getting information about specific MIDI input driver parameter</h3>
2430    
2431  <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:
2432  </p>  </p>
# Line 2280  Intellectual Property and Copyright Stat Line 2436  Intellectual Property and Copyright Stat
2436  <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;]
2437  </p>  </p>
2438  </blockquote><p>  </blockquote><p>
2439                        
2440  </p>  </p>
2441  <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
2442                      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
2443                      parameter name for which information should be obtained (as returned by the                      parameter name for which information should be obtained (as returned by the
2444                      <a class="info" href="#GET MIDI_INPUT_DRIVER INFO">"GET MIDI_INPUT_DRIVER INFO"<span> (</span><span class="info">Getting information about a specific MIDI input driver</span><span>)</span></a> command) and &lt;deplist&gt; is an optional list                      <a class='info' href='#GET MIDI_INPUT_DRIVER INFO'>"GET MIDI_INPUT_DRIVER INFO"<span> (</span><span class='info'>Getting information about a specific MIDI input driver</span><span>)</span></a> command) and &lt;deplist&gt; is an optional list
2445                      of parameters on which the sought parameter &lt;param&gt; depends on,                      of parameters on which the sought parameter &lt;param&gt; depends on,
2446                      &lt;deplist&gt; is a key-value pair list in form of "key1=val1 key2=val2 ...",                      &lt;deplist&gt; is a key-value pair list in form of "key1=val1 key2=val2 ...",
2447                      where character string values are encapsulated into apostrophes ('). Arguments                      where character string values are encapsulated into apostrophes ('). Arguments
# Line 2315  Intellectual Property and Copyright Stat Line 2471  Intellectual Property and Copyright Stat
2471                                  character string(s)                                  character string(s)
2472                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2473  </p>  </p>
2474  </blockquote><p>  </blockquote>
2475                                
2476    
 </p>  
2477  <p>DESCRIPTION -  <p>DESCRIPTION -
2478                                </p>                                </p>
2479  <blockquote class="text">  <blockquote class="text">
2480  <p>arbitrary text describing the purpose of the parameter  <p>arbitrary text describing the purpose of the parameter
2481                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2482  </p>  </p>
2483  </blockquote><p>  </blockquote>
2484                                
2485    
 </p>  
2486  <p>MANDATORY -  <p>MANDATORY -
2487                                </p>                                </p>
2488  <blockquote class="text">  <blockquote class="text">
2489  <p>either true or false, defines if this parameter must be  <p>either true or false, defines if this parameter must be
2490                                  given when the device is to be created with the                                  given when the device is to be created with the
2491                                  <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
2492                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2493  </p>  </p>
2494  </blockquote><p>  </blockquote>
2495                                
2496    
 </p>  
2497  <p>FIX -  <p>FIX -
2498                                </p>                                </p>
2499  <blockquote class="text">  <blockquote class="text">
2500  <p>either true or false, if false then this parameter can  <p>either true or false, if false then this parameter can
2501                                  be changed at any time, once the device is created by                                  be changed at any time, once the device is created by
2502                                  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
2503                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2504  </p>  </p>
2505  </blockquote><p>  </blockquote>
2506                                
2507    
 </p>  
2508  <p>MULTIPLICITY -  <p>MULTIPLICITY -
2509                                </p>                                </p>
2510  <blockquote class="text">  <blockquote class="text">
# Line 2357  Intellectual Property and Copyright Stat Line 2513  Intellectual Property and Copyright Stat
2513                                  multiple values and false only a single value allowed                                  multiple values and false only a single value allowed
2514                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2515  </p>  </p>
2516  </blockquote><p>  </blockquote>
2517                                
2518    
 </p>  
2519  <p>DEPENDS -  <p>DEPENDS -
2520                                </p>                                </p>
2521  <blockquote class="text">  <blockquote class="text">
# Line 2374  Intellectual Property and Copyright Stat Line 2530  Intellectual Property and Copyright Stat
2530                                  chosen by the 'card' parameter                                  chosen by the 'card' parameter
2531                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2532  </p>  </p>
2533  </blockquote><p>  </blockquote>
2534                                
2535    
 </p>  
2536  <p>DEFAULT -  <p>DEFAULT -
2537                                </p>                                </p>
2538  <blockquote class="text">  <blockquote class="text">
2539  <p>reflects the default value for this parameter which is  <p>reflects the default value for this parameter which is
2540                                  used when the device is created and not explicitly                                  used when the device is created and not explicitly
2541                                  given with 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,                                  given with 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,
2542                                  in case of MULTIPLCITY=true, this is a comma separated                                  in case of MULTIPLCITY=true, this is a comma separated
2543                                  list, that's why character strings are encapsulated into                                  list, that's why character strings are encapsulated into
2544                                  apostrophes (')                                  apostrophes (')
2545                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2546  </p>  </p>
2547  </blockquote><p>  </blockquote>
2548                                
2549    
 </p>  
2550  <p>RANGE_MIN -  <p>RANGE_MIN -
2551                                </p>                                </p>
2552  <blockquote class="text">  <blockquote class="text">
# Line 2400  Intellectual Property and Copyright Stat Line 2556  Intellectual Property and Copyright Stat
2556                                  with RANGE_MAX, but may also appear without                                  with RANGE_MAX, but may also appear without
2557                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2558  </p>  </p>
2559  </blockquote><p>  </blockquote>
2560                                
2561    
 </p>  
2562  <p>RANGE_MAX -  <p>RANGE_MAX -
2563                                </p>                                </p>
2564  <blockquote class="text">  <blockquote class="text">
# Line 2412  Intellectual Property and Copyright Stat Line 2568  Intellectual Property and Copyright Stat
2568                                  RANGE_MIN, but may also appear without                                  RANGE_MIN, but may also appear without
2569                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2570  </p>  </p>
2571  </blockquote><p>  </blockquote>
2572                                
2573    
 </p>  
2574  <p>POSSIBILITIES -  <p>POSSIBILITIES -
2575                                </p>                                </p>
2576  <blockquote class="text">  <blockquote class="text">
# Line 2423  Intellectual Property and Copyright Stat Line 2579  Intellectual Property and Copyright Stat
2579                                  apostrophes                                  apostrophes
2580                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2581  </p>  </p>
2582  </blockquote><p>  </blockquote>
2583                                
2584    
 </p>  
2585  </blockquote><p>  </blockquote><p>
2586                        
2587  </p>  </p>
2588  <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.
2589  </p>  </p>
# Line 2453  Intellectual Property and Copyright Stat Line 2609  Intellectual Property and Copyright Stat
2609  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2610  </p>  </p>
2611  </blockquote><p>  </blockquote><p>
2612                        
2613  </p>  </p>
2614  <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 />
2615    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2616    <a name="rfc.section.6.3.5"></a><h3>6.3.5.&nbsp;
2617    Creating a MIDI input device</h3>
2618    
2619  <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:
2620  </p>  </p>
# Line 2465  Intellectual Property and Copyright Stat Line 2624  Intellectual Property and Copyright Stat
2624  <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;]
2625  </p>  </p>
2626  </blockquote><p>  </blockquote><p>
2627                        
2628  </p>  </p>
2629  <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
2630                      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
2631                      optional list of driver specific parameters in form of "key1=val1 key2=val2 ...", where                      optional list of driver specific parameters in form of "key1=val1 key2=val2 ...", where
2632                      character string values should be encapsulated into apostrophes (').                      character string values should be encapsulated into apostrophes (').
2633                      Note that there might be drivers which require parameter(s) to be                      Note that there might be drivers which require parameter(s) to be
# Line 2486  Intellectual Property and Copyright Stat Line 2645  Intellectual Property and Copyright Stat
2645  <p>in case the device was successfully created, where  <p>in case the device was successfully created, where
2646                                      &lt;device-id&gt; is the numerical ID of the new device                                      &lt;device-id&gt; is the numerical ID of the new device
2647  </p>  </p>
2648  </blockquote><p>  </blockquote>
2649                                
2650    
 </p>  
2651  <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;" -
2652                                  </p>                                  </p>
2653  <blockquote class="text">  <blockquote class="text">
# Line 2497  Intellectual Property and Copyright Stat Line 2656  Intellectual Property and Copyright Stat
2656                                      there are noteworthy issue(s) related, providing an                                      there are noteworthy issue(s) related, providing an
2657                                      appropriate warning code and warning message                                      appropriate warning code and warning message
2658  </p>  </p>
2659  </blockquote><p>  </blockquote>
2660                                
2661    
 </p>  
2662  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2663                                  </p>                                  </p>
2664  <blockquote class="text">  <blockquote class="text">
2665  <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
2666  </p>  </p>
2667  </blockquote><p>  </blockquote>
2668                                
2669    
 </p>  
2670  </blockquote><p>  </blockquote><p>
2671                        
2672  </p>  </p>
2673  <p>Example:  <p>Example:
2674  </p>  </p>
# Line 2521  Intellectual Property and Copyright Stat Line 2680  Intellectual Property and Copyright Stat
2680  <p>S: "OK[0]"  <p>S: "OK[0]"
2681  </p>  </p>
2682  </blockquote><p>  </blockquote><p>
2683                        
2684  </p>  </p>
2685  <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 />
2686    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2687    <a name="rfc.section.6.3.6"></a><h3>6.3.6.&nbsp;
2688    Destroying a MIDI input device</h3>
2689    
2690  <p>Use the following command to destroy a created MIDI input device:  <p>Use the following command to destroy a created MIDI input device:
2691  </p>  </p>
# Line 2533  Intellectual Property and Copyright Stat Line 2695  Intellectual Property and Copyright Stat
2695  <p>DESTROY MIDI_INPUT_DEVICE &lt;device-id&gt;  <p>DESTROY MIDI_INPUT_DEVICE &lt;device-id&gt;
2696  </p>  </p>
2697  </blockquote><p>  </blockquote><p>
2698                        
2699  </p>  </p>
2700  <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
2701                      <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>
2702                      or <a class="info" href="#LIST MIDI_INPUT_DEVICES">"LIST MIDI_INPUT_DEVICES"<span> (</span><span class="info">Getting all created MIDI input device list</span><span>)</span></a>                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a>
2703                      command.                      command.
2704  </p>  </p>
2705  <p>Possible Answers:  <p>Possible Answers:
# Line 2550  Intellectual Property and Copyright Stat Line 2712  Intellectual Property and Copyright Stat
2712  <blockquote class="text">  <blockquote class="text">
2713  <p>in case the device was successfully destroyed  <p>in case the device was successfully destroyed
2714  </p>  </p>
2715  </blockquote><p>  </blockquote>
2716                                
2717    
 </p>  
2718  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
2719                                  </p>                                  </p>
2720  <blockquote class="text">  <blockquote class="text">
# Line 2560  Intellectual Property and Copyright Stat Line 2722  Intellectual Property and Copyright Stat
2722                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
2723                                      warning message                                      warning message
2724  </p>  </p>
2725  </blockquote><p>  </blockquote>
2726                                
2727    
 </p>  
2728  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2729                                  </p>                                  </p>
2730  <blockquote class="text">  <blockquote class="text">
2731  <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
2732  </p>  </p>
2733  </blockquote><p>  </blockquote>
2734                                
2735    
 </p>  
2736  </blockquote><p>  </blockquote><p>
2737                        
2738  </p>  </p>
2739  <p>Example:  <p>Example:
2740  </p>  </p>
# Line 2584  Intellectual Property and Copyright Stat Line 2746  Intellectual Property and Copyright Stat
2746  <p>S: "OK"  <p>S: "OK"
2747  </p>  </p>
2748  </blockquote><p>  </blockquote><p>
2749                        
2750  </p>  </p>
2751  <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 />
2752    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2753    <a name="rfc.section.6.3.7"></a><h3>6.3.7.&nbsp;
2754    Getting all created MIDI input device count</h3>
2755    
2756  <p>Use the following command to count all created MIDI input devices:  <p>Use the following command to count all created MIDI input devices:
2757  </p>  </p>
# Line 2596  Intellectual Property and Copyright Stat Line 2761  Intellectual Property and Copyright Stat
2761  <p>GET MIDI_INPUT_DEVICES  <p>GET MIDI_INPUT_DEVICES
2762  </p>  </p>
2763  </blockquote><p>  </blockquote><p>
2764                        
2765  </p>  </p>
2766  <p>Possible Answers:  <p>Possible Answers:
2767  </p>  </p>
# Line 2607  Intellectual Property and Copyright Stat Line 2772  Intellectual Property and Copyright Stat
2772                              MIDI input devices.                              MIDI input devices.
2773  </p>  </p>
2774  </blockquote><p>  </blockquote><p>
2775                        
2776  </p>  </p>
2777  <p>Example:  <p>Example:
2778  </p>  </p>
# Line 2619  Intellectual Property and Copyright Stat Line 2784  Intellectual Property and Copyright Stat
2784  <p>S: "3"  <p>S: "3"
2785  </p>  </p>
2786  </blockquote><p>  </blockquote><p>
2787                        
2788  </p>  </p>
2789  <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 />
2790    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2791    <a name="rfc.section.6.3.8"></a><h3>6.3.8.&nbsp;
2792    Getting all created MIDI input device list</h3>
2793    
2794  <p>Use the following command to list all created MIDI input devices:  <p>Use the following command to list all created MIDI input devices:
2795  </p>  </p>
# Line 2631  Intellectual Property and Copyright Stat Line 2799  Intellectual Property and Copyright Stat
2799  <p>LIST MIDI_INPUT_DEVICES  <p>LIST MIDI_INPUT_DEVICES
2800  </p>  </p>
2801  </blockquote><p>  </blockquote><p>
2802                        
2803  </p>  </p>
2804  <p>Possible Answers:  <p>Possible Answers:
2805  </p>  </p>
# Line 2642  Intellectual Property and Copyright Stat Line 2810  Intellectual Property and Copyright Stat
2810                              with the numerical Ids of all created MIDI input devices.                              with the numerical Ids of all created MIDI input devices.
2811  </p>  </p>
2812  </blockquote><p>  </blockquote><p>
2813                        
2814  </p>  </p>
2815  <p>Examples:  <p>Examples:
2816  </p>  </p>
# Line 2654  Intellectual Property and Copyright Stat Line 2822  Intellectual Property and Copyright Stat
2822  <p>S: "0,1,2"  <p>S: "0,1,2"
2823  </p>  </p>
2824  </blockquote><p>  </blockquote><p>
2825                        
2826  </p>  </p>
2827  <p>  <p>
2828                          </p>                          </p>
# Line 2664  Intellectual Property and Copyright Stat Line 2832  Intellectual Property and Copyright Stat
2832  <p>S: "1,3"  <p>S: "1,3"
2833  </p>  </p>
2834  </blockquote><p>  </blockquote><p>
2835                        
2836  </p>  </p>
2837  <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 />
2838    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2839    <a name="rfc.section.6.3.9"></a><h3>6.3.9.&nbsp;
2840    Getting current settings of a MIDI input device</h3>
2841    
2842  <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:
2843  </p>  </p>
# Line 2676  Intellectual Property and Copyright Stat Line 2847  Intellectual Property and Copyright Stat
2847  <p>GET MIDI_INPUT_DEVICE INFO &lt;device-id&gt;  <p>GET MIDI_INPUT_DEVICE INFO &lt;device-id&gt;
2848  </p>  </p>
2849  </blockquote><p>  </blockquote><p>
2850                        
2851  </p>  </p>
2852  <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
2853                      <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>
2854                      or <a class="info" href="#LIST MIDI_INPUT_DEVICES">"LIST MIDI_INPUT_DEVICES"<span> (</span><span class="info">Getting all created MIDI input device list</span><span>)</span></a>                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a>
2855                      command.                      command.
2856  </p>  </p>
2857  <p>Possible Answers:  <p>Possible Answers:
# Line 2703  Intellectual Property and Copyright Stat Line 2874  Intellectual Property and Copyright Stat
2874                                          </p>                                          </p>
2875  <blockquote class="text">  <blockquote class="text">
2876  <p>identifier of the used MIDI input driver, as e.g.  <p>identifier of the used MIDI input driver, as e.g.
2877                                              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>
2878                                              command                                              command
2879  </p>  </p>
2880  </blockquote><p>  </blockquote>
2881                                        
2882    
2883  </p>  </blockquote>
2884  </blockquote><p>                                  
                                 </p>  
2885  <blockquote class="text">  <blockquote class="text">
2886  <p>ACTIVE -  <p>ACTIVE -
2887                                          </p>                                          </p>
# Line 2720  Intellectual Property and Copyright Stat Line 2891  Intellectual Property and Copyright Stat
2891                                              and thus doesn't forward them to connected sampler                                              and thus doesn't forward them to connected sampler
2892                                              channels                                              channels
2893  </p>  </p>
2894  </blockquote><p>  </blockquote>
2895                                        
2896    
2897  </p>  </blockquote>
2898  </blockquote><p>                              
2899    
 </p>  
2900  </blockquote><p>  </blockquote><p>
2901                        
2902  </p>  </p>
2903  <p>The mentioned fields above don't have to be in particular  <p>The mentioned fields above don't have to be in particular
2904                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
2905                      returned by all MIDI input devices. Every MIDI input driver                      returned by all MIDI input devices. Every MIDI input driver
2906                      might have its own, additional driver specific parameters (see                      might have its own, additional driver specific parameters (see
2907                      <a class="info" href="#GET MIDI_INPUT_DRIVER INFO">"GET MIDI_INPUT_DRIVER INFO"<span> (</span><span class="info">Getting information about a specific MIDI input driver</span><span>)</span></a> command) which are also returned                      <a class='info' href='#GET MIDI_INPUT_DRIVER INFO'>"GET MIDI_INPUT_DRIVER INFO"<span> (</span><span class='info'>Getting information about a specific MIDI input driver</span><span>)</span></a> command) which are also returned
2908                      by this command.                      by this command.
2909  </p>  </p>
2910  <p>Example:  <p>Example:
# Line 2750  Intellectual Property and Copyright Stat Line 2921  Intellectual Property and Copyright Stat
2921  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2922  </p>  </p>
2923  </blockquote><p>  </blockquote><p>
2924                        
2925  </p>  </p>
2926  <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 />
2927    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2928    <a name="rfc.section.6.3.10"></a><h3>6.3.10.&nbsp;
2929    Changing settings of MIDI input devices</h3>
2930    
2931  <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:
2932  </p>  </p>
# Line 2762  Intellectual Property and Copyright Stat Line 2936  Intellectual Property and Copyright Stat
2936  <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;
2937  </p>  </p>
2938  </blockquote><p>  </blockquote><p>
2939                        
2940  </p>  </p>
2941  <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
2942                      MIDI input device as returned by the                      MIDI input device as returned by the
2943                      <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>
2944                      or <a class="info" href="#LIST MIDI_INPUT_DEVICES">"LIST MIDI_INPUT_DEVICES"<span> (</span><span class="info">Getting all created MIDI input device list</span><span>)</span></a>                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a>
2945                      command, &lt;key&gt; by the name of the parameter to change and                      command, &lt;key&gt; by the name of the parameter to change and
2946                      &lt;value&gt; by the new value for this parameter.                      &lt;value&gt; by the new value for this parameter.
2947  </p>  </p>
# Line 2781  Intellectual Property and Copyright Stat Line 2955  Intellectual Property and Copyright Stat
2955  <blockquote class="text">  <blockquote class="text">
2956  <p>in case setting was successfully changed  <p>in case setting was successfully changed
2957  </p>  </p>
2958  </blockquote><p>  </blockquote>
2959                                
2960    
 </p>  
2961  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
2962                                  </p>                                  </p>
2963  <blockquote class="text">  <blockquote class="text">
# Line 2791  Intellectual Property and Copyright Stat Line 2965  Intellectual Property and Copyright Stat
2965                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
2966                                      warning code and warning message                                      warning code and warning message
2967  </p>  </p>
2968  </blockquote><p>  </blockquote>
2969                                
2970    
 </p>  
2971  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2972                                  </p>                                  </p>
2973  <blockquote class="text">  <blockquote class="text">
2974  <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
2975  </p>  </p>
2976  </blockquote><p>  </blockquote>
2977                                
2978    
 </p>  
2979  </blockquote><p>  </blockquote><p>
2980                        
2981  </p>  </p>
2982  <p>Example:  <p>Example:
2983  </p>  </p>
# Line 2815  Intellectual Property and Copyright Stat Line 2989  Intellectual Property and Copyright Stat
2989  <p>S: "OK"  <p>S: "OK"
2990  </p>  </p>
2991  </blockquote><p>  </blockquote><p>
2992                        
2993  </p>  </p>
2994  <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 />
2995    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
2996    <a name="rfc.section.6.3.11"></a><h3>6.3.11.&nbsp;
2997    Getting information about a MIDI port</h3>
2998    
2999  <p>Use the following command to get information about a MIDI port:  <p>Use the following command to get information about a MIDI port:
3000  </p>  </p>
# Line 2827  Intellectual Property and Copyright Stat Line 3004  Intellectual Property and Copyright Stat
3004  <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;
3005  </p>  </p>
3006  </blockquote><p>  </blockquote><p>
3007                        
3008  </p>  </p>
3009  <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
3010                      <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>
3011                      or <a class="info" href="#LIST MIDI_INPUT_DEVICES">"LIST MIDI_INPUT_DEVICES"<span> (</span><span class="info">Getting all created MIDI input device list</span><span>)</span></a>                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a>
3012                      command and &lt;midi-port&gt; the MIDI input port number.                      command and &lt;midi-port&gt; the MIDI input port number.
3013  </p>  </p>
3014  <p>Possible Answers:  <p>Possible Answers:
# Line 2850  Intellectual Property and Copyright Stat Line 3027  Intellectual Property and Copyright Stat
3027  <blockquote class="text">  <blockquote class="text">
3028  <p>arbitrary character string naming the port  <p>arbitrary character string naming the port
3029  </p>  </p>
3030  </blockquote><p>  </blockquote>
3031                                
3032    
 </p>  
3033  </blockquote><p>  </blockquote><p>
3034                        
3035  </p>  </p>
3036  <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
3037                      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 3052  Intellectual Property and Copyright Stat
3052  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
3053  </p>  </p>
3054  </blockquote><p>  </blockquote><p>
3055                        
3056  </p>  </p>
3057  <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 />
3058    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3059    <a name="rfc.section.6.3.12"></a><h3>6.3.12.&nbsp;
3060    Getting information about specific MIDI port parameter</h3>
3061    
3062  <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:
3063  </p>  </p>
# Line 2887  Intellectual Property and Copyright Stat Line 3067  Intellectual Property and Copyright Stat
3067  <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;
3068  </p>  </p>
3069  </blockquote><p>  </blockquote><p>
3070                        
3071  </p>  </p>
3072  <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
3073                      <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>
3074                      or <a class="info" href="#LIST MIDI_INPUT_DEVICES">"LIST MIDI_INPUT_DEVICES"<span> (</span><span class="info">Getting all created MIDI input device list</span><span>)</span></a>                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a>
3075                      command, &lt;port&gt; the MIDI port number and                      command, &lt;port&gt; the MIDI port number and
3076                      &lt;param&gt; a specific port parameter name for which information should be                      &lt;param&gt; a specific port parameter name for which information should be
3077                      obtained (as returned by the <a class="info" href="#GET MIDI_INPUT_PORT INFO">"GET MIDI_INPUT_PORT INFO"<span> (</span><span class="info">Getting information about a MIDI port</span><span>)</span></a> command).                      obtained (as returned by the <a class='info' href='#GET MIDI_INPUT_PORT INFO'>"GET MIDI_INPUT_PORT INFO"<span> (</span><span class='info'>Getting information about a MIDI port</span><span>)</span></a> command).
3078  </p>  </p>
3079  <p>Possible Answers:  <p>Possible Answers:
3080  </p>  </p>
# Line 2918  Intellectual Property and Copyright Stat Line 3098  Intellectual Property and Copyright Stat
3098                                      character string(s)                                      character string(s)
3099                                      (always returned)                                      (always returned)
3100  </p>  </p>
3101  </blockquote><p>  </blockquote>
3102                                
3103    
 </p>  
3104  <p>DESCRIPTION -  <p>DESCRIPTION -
3105                                  </p>                                  </p>
3106  <blockquote class="text">  <blockquote class="text">
3107  <p>arbitrary text describing the purpose of the parameter  <p>arbitrary text describing the purpose of the parameter
3108                                      (always returned)                                      (always returned)
3109  </p>  </p>
3110  </blockquote><p>  </blockquote>
3111                                
3112    
 </p>  
3113  <p>FIX -  <p>FIX -
3114                                  </p>                                  </p>
3115  <blockquote class="text">  <blockquote class="text">
# Line 2937  Intellectual Property and Copyright Stat Line 3117  Intellectual Property and Copyright Stat
3117                                      read only, thus cannot be altered                                      read only, thus cannot be altered
3118                                      (always returned)                                      (always returned)
3119  </p>  </p>
3120  </blockquote><p>  </blockquote>
3121                                
3122    
 </p>  
3123  <p>MULTIPLICITY -  <p>MULTIPLICITY -
3124                                  </p>                                  </p>
3125  <blockquote class="text">  <blockquote class="text">
# Line 2948  Intellectual Property and Copyright Stat Line 3128  Intellectual Property and Copyright Stat
3128                                      multiple values and false only a single value allowed                                      multiple values and false only a single value allowed
3129                                      (always returned)                                      (always returned)
3130  </p>  </p>
3131  </blockquote><p>  </blockquote>
3132                                
3133    
 </p>  
3134  <p>RANGE_MIN -  <p>RANGE_MIN -
3135                                  </p>                                  </p>
3136  <blockquote class="text">  <blockquote class="text">
# Line 2961  Intellectual Property and Copyright Stat Line 3141  Intellectual Property and Copyright Stat
3141                                      (optionally returned, dependent to driver and port                                      (optionally returned, dependent to driver and port
3142                                      parameter)                                      parameter)
3143  </p>  </p>
3144  </blockquote><p>  </blockquote>
3145                                
3146    
 </p>  
3147  <p>RANGE_MAX -  <p>RANGE_MAX -
3148                                  </p>                                  </p>
3149  <blockquote class="text">  <blockquote class="text">
# Line 2974  Intellectual Property and Copyright Stat Line 3154  Intellectual Property and Copyright Stat
3154                                      (optionally returned, dependent to driver and port                                      (optionally returned, dependent to driver and port
3155                                      parameter)                                      parameter)
3156  </p>  </p>
3157  </blockquote><p>  </blockquote>
3158                                
3159    
 </p>  
3160  <p>POSSIBILITIES -  <p>POSSIBILITIES -
3161                                  </p>                                  </p>
3162  <blockquote class="text">  <blockquote class="text">
# Line 2986  Intellectual Property and Copyright Stat Line 3166  Intellectual Property and Copyright Stat
3166                                      (optionally returned, dependent to device and port                                      (optionally returned, dependent to device and port
3167                                      parameter)                                      parameter)
3168  </p>  </p>
3169  </blockquote><p>  </blockquote>
3170                                
3171    
 </p>  
3172  </blockquote><p>  </blockquote><p>
3173                        
3174  </p>  </p>
3175  <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.
3176  </p>  </p>
# Line 3014  Intellectual Property and Copyright Stat Line 3194  Intellectual Property and Copyright Stat
3194  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
3195  </p>  </p>
3196  </blockquote><p>  </blockquote><p>
3197                        
3198  </p>  </p>
3199  <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 />
3200    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3201    <a name="rfc.section.6.3.13"></a><h3>6.3.13.&nbsp;
3202    Changing settings of MIDI input ports</h3>
3203    
3204  <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:
3205  </p>  </p>
# Line 3026  Intellectual Property and Copyright Stat Line 3209  Intellectual Property and Copyright Stat
3209  <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;
3210  </p>  </p>
3211  </blockquote><p>  </blockquote><p>
3212                        
3213  </p>  </p>
3214  <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
3215                      MIDI device as returned by the                      MIDI device as returned by the
3216                      <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>
3217                      or <a class="info" href="#LIST MIDI_INPUT_DEVICES">"LIST MIDI_INPUT_DEVICES"<span> (</span><span class="info">Getting all created MIDI input device list</span><span>)</span></a>                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a>
3218                      command, &lt;port&gt; by the MIDI port number, &lt;key&gt; by the name of                      command, &lt;port&gt; by the MIDI port number, &lt;key&gt; by the name of
3219                      the parameter to change and &lt;value&gt; by the new value for this                      the parameter to change and &lt;value&gt; by the new value for this
3220                      parameter.                      parameter.
# Line 3046  Intellectual Property and Copyright Stat Line 3229  Intellectual Property and Copyright Stat
3229  <blockquote class="text">  <blockquote class="text">
3230  <p>in case setting was successfully changed  <p>in case setting was successfully changed
3231  </p>  </p>
3232  </blockquote><p>  </blockquote>
3233                                
3234    
 </p>  
3235  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3236                                  </p>                                  </p>
3237  <blockquote class="text">  <blockquote class="text">
# Line 3056  Intellectual Property and Copyright Stat Line 3239  Intellectual Property and Copyright Stat
3239                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
3240                                      warning code and warning message                                      warning code and warning message
3241  </p>  </p>
3242  </blockquote><p>  </blockquote>
3243                                
3244    
 </p>  
3245  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3246                                  </p>                                  </p>
3247  <blockquote class="text">  <blockquote class="text">
3248  <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
3249  </p>  </p>
3250  </blockquote><p>  </blockquote>
3251                                
3252    
 </p>  
3253  </blockquote><p>  </blockquote><p>
3254                        
3255  </p>  </p>
3256  <p>Example:  <p>Example:
3257  </p>  </p>
# Line 3078  Intellectual Property and Copyright Stat Line 3261  Intellectual Property and Copyright Stat
3261  <p>  <p>
3262  </p>  </p>
3263  </blockquote><p>  </blockquote><p>
3264                        
3265  </p>  </p>
3266  <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 />
3267    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3268    <a name="rfc.section.6.4"></a><h3>6.4.&nbsp;
3269    Configuring sampler channels</h3>
3270    
3271  <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
3272                  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
3273                  MIDI and audio devices.                  MIDI and audio devices.
3274  </p>  </p>
3275  <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 />
3276    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3277    <a name="rfc.section.6.4.1"></a><h3>6.4.1.&nbsp;
3278    Loading an instrument</h3>
3279    
3280  <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:
3281  </p>  </p>
# Line 3096  Intellectual Property and Copyright Stat Line 3285  Intellectual Property and Copyright Stat
3285  <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;
3286  </p>  </p>
3287  </blockquote><p>  </blockquote><p>
3288                        
3289  </p>  </p>
3290  <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
3291                      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 3108  Intellectual Property and Copyright Stat Line 3297  Intellectual Property and Copyright Stat
3297                      is that the regular command returns OK only after the instrument has been                      is that the regular command returns OK only after the instrument has been
3298                      fully loaded and the channel is ready to be used while NON_MODAL version                      fully loaded and the channel is ready to be used while NON_MODAL version
3299                      returns immediately and a background process is launched to load the instrument                      returns immediately and a background process is launched to load the instrument
3300                      on the channel. The <a class="info" href="#GET CHANNEL INFO">GET CHANNEL INFO<span> (</span><span class="info">Getting sampler channel information</span><span>)</span></a>                      on the channel. The <a class='info' href='#GET CHANNEL INFO'>GET CHANNEL INFO<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a>
3301                      command can be used to obtain loading                      command can be used to obtain loading
3302                      progress from INSTRUMENT_STATUS field. LOAD command will perform sanity checks                      progress from INSTRUMENT_STATUS field. LOAD command will perform sanity checks
3303                      such as making sure that the file could be read and it is of a proper format                      such as making sure that the file could be read and it is of a proper format
# Line 3125  Intellectual Property and Copyright Stat Line 3314  Intellectual Property and Copyright Stat
3314  <blockquote class="text">  <blockquote class="text">
3315  <p>in case the instrument was successfully loaded  <p>in case the instrument was successfully loaded
3316  </p>  </p>
3317  </blockquote><p>  </blockquote>
3318                                
3319    
 </p>  
3320  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3321                                  </p>                                  </p>
3322  <blockquote class="text">  <blockquote class="text">
# Line 3137  Intellectual Property and Copyright Stat Line 3326  Intellectual Property and Copyright Stat
3326                                      instrument file), providing an appropriate warning code and                                      instrument file), providing an appropriate warning code and
3327                                      warning message                                      warning message
3328  </p>  </p>
3329  </blockquote><p>  </blockquote>
3330                                
3331    
 </p>  
3332  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3333                                  </p>                                  </p>
3334  <blockquote class="text">  <blockquote class="text">
3335  <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
3336  </p>  </p>
3337  </blockquote><p>  </blockquote>
3338                                
3339    
 </p>  
3340  </blockquote><p>  </blockquote><p>
3341                        
3342  </p>  </p>
3343  <p>Example:  <p>Example:
3344  </p>  </p>
# Line 3159  Intellectual Property and Copyright Stat Line 3348  Intellectual Property and Copyright Stat
3348  <p>  <p>
3349  </p>  </p>
3350  </blockquote><p>  </blockquote><p>
3351                        
3352  </p>  </p>
3353  <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 />
3354    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3355    <a name="rfc.section.6.4.2"></a><h3>6.4.2.&nbsp;
3356    Loading a sampler engine</h3>
3357    
3358  <p>A sampler engine type can be associated to a specific sampler  <p>A sampler engine type can be associated to a specific sampler
3359                      channel by the following command:                      channel by the following command:
# Line 3172  Intellectual Property and Copyright Stat Line 3364  Intellectual Property and Copyright Stat
3364  <p>LOAD ENGINE &lt;engine-name&gt; &lt;sampler-channel&gt;  <p>LOAD ENGINE &lt;engine-name&gt; &lt;sampler-channel&gt;
3365  </p>  </p>
3366  </blockquote><p>  </blockquote><p>
3367                        
3368  </p>  </p>
3369  <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
3370                      <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;
3371                      the sampler channel as returned by the                      the sampler channel as returned by the
3372                      <a class="info" href="#ADD CHANNEL">"ADD CHANNEL"<span> (</span><span class="info">Adding a new sampler channel</span><span>)</span></a> or                      <a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a> or
3373                      <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command where                      <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command where
3374                      the engine type should be assigned to. This command should be issued                      the engine type should be assigned to. This command should be issued
3375                      after adding a new sampler channel and before any other control                      after adding a new sampler channel and before any other control
3376                      commands on the new sampler channel. It can also be used to change                      commands on the new sampler channel. It can also be used to change
# Line 3198  Intellectual Property and Copyright Stat Line 3390  Intellectual Property and Copyright Stat
3390  <blockquote class="text">  <blockquote class="text">
3391  <p>in case the engine was successfully deployed  <p>in case the engine was successfully deployed
3392  </p>  </p>
3393  </blockquote><p>  </blockquote>
3394                                
3395    
 </p>  
3396  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3397                                  </p>                                  </p>
3398  <blockquote class="text">  <blockquote class="text">
# Line 3208  Intellectual Property and Copyright Stat Line 3400  Intellectual Property and Copyright Stat
3400                                      are noteworthy issue(s) related, providing an appropriate                                      are noteworthy issue(s) related, providing an appropriate
3401                                      warning code and warning message                                      warning code and warning message
3402  </p>  </p>
3403  </blockquote><p>  </blockquote>
3404                                
3405    
 </p>  
3406  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3407                                  </p>                                  </p>
3408  <blockquote class="text">  <blockquote class="text">
3409  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
3410                                      error message                                      error message
3411  </p>  </p>
3412  </blockquote><p>  </blockquote>
3413                                
3414    
 </p>  
3415  </blockquote><p>  </blockquote><p>
3416                        
3417  </p>  </p>
3418  <p>Example:  <p>Example:
3419  </p>  </p>
# Line 3231  Intellectual Property and Copyright Stat Line 3423  Intellectual Property and Copyright Stat
3423  <p>  <p>
3424  </p>  </p>
3425  </blockquote><p>  </blockquote><p>
3426                        
3427  </p>  </p>
3428  <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 />
3429    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3430    <a name="rfc.section.6.4.3"></a><h3>6.4.3.&nbsp;
3431    Getting all created sampler channel count</h3>
3432    
3433  <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
3434                      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 3440  Intellectual Property and Copyright Stat
3440  <p>GET CHANNELS  <p>GET CHANNELS
3441  </p>  </p>
3442  </blockquote><p>  </blockquote><p>
3443                        
3444  </p>  </p>
3445  <p>Possible Answers:  <p>Possible Answers:
3446  </p>  </p>
# Line 3255  Intellectual Property and Copyright Stat Line 3450  Intellectual Property and Copyright Stat
3450  <p>LinuxSampler will answer by returning the current number of sampler channels.  <p>LinuxSampler will answer by returning the current number of sampler channels.
3451  </p>  </p>
3452  </blockquote><p>  </blockquote><p>
3453                        
3454  </p>  </p>
3455  <p>Example:  <p>Example:
3456  </p>  </p>
# Line 3267  Intellectual Property and Copyright Stat Line 3462  Intellectual Property and Copyright Stat
3462  <p>S: "12"  <p>S: "12"
3463  </p>  </p>
3464  </blockquote><p>  </blockquote><p>
3465                        
3466  </p>  </p>
3467  <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 />
3468    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3469    <a name="rfc.section.6.4.4"></a><h3>6.4.4.&nbsp;
3470    Getting all created sampler channel list</h3>
3471    
3472  <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
3473                      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 3479  Intellectual Property and Copyright Stat
3479  <p>LIST CHANNELS  <p>LIST CHANNELS
3480  </p>  </p>
3481  </blockquote><p>  </blockquote><p>
3482                        
3483  </p>  </p>
3484  <p>Possible Answers:  <p>Possible Answers:
3485  </p>  </p>
# Line 3292  Intellectual Property and Copyright Stat Line 3490  Intellectual Property and Copyright Stat
3490                              with all sampler channels numerical IDs.                              with all sampler channels numerical IDs.
3491  </p>  </p>
3492  </blockquote><p>  </blockquote><p>
3493                        
3494  </p>  </p>
3495  <p>Example:  <p>Example:
3496  </p>  </p>
# Line 3304  Intellectual Property and Copyright Stat Line 3502  Intellectual Property and Copyright Stat
3502  <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"
3503  </p>  </p>
3504  </blockquote><p>  </blockquote><p>
3505                        
3506  </p>  </p>
3507  <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 />
3508    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3509    <a name="rfc.section.6.4.5"></a><h3>6.4.5.&nbsp;
3510    Adding a new sampler channel</h3>
3511    
3512  <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
3513                      channel list by sending the following command:                      channel list by sending the following command:
# Line 3317  Intellectual Property and Copyright Stat Line 3518  Intellectual Property and Copyright Stat
3518  <p>ADD CHANNEL  <p>ADD CHANNEL
3519  </p>  </p>
3520  </blockquote><p>  </blockquote><p>
3521                        
3522  </p>  </p>
3523  <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
3524                      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 3544  Intellectual Property and Copyright Stat
3544                                      the sampler channel by sending subsequent initialization                                      the sampler channel by sending subsequent initialization
3545                                      commands                                      commands
3546  </p>  </p>
3547  </blockquote><p>  </blockquote>
3548                                
3549    
 </p>  
3550  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3551                                  </p>                                  </p>
3552  <blockquote class="text">  <blockquote class="text">
# Line 3353  Intellectual Property and Copyright Stat Line 3554  Intellectual Property and Copyright Stat
3554                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
3555                                      warning code and warning message                                      warning code and warning message
3556  </p>  </p>
3557  </blockquote><p>  </blockquote>
3558                                
3559    
 </p>  
3560  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3561                                  </p>                                  </p>
3562  <blockquote class="text">  <blockquote class="text">
3563  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
3564                                      error message                                      error message
3565  </p>  </p>
3566  </blockquote><p>  </blockquote>
3567                                
3568    
 </p>  
3569  </blockquote><p>  </blockquote><p>
3570                        
3571  </p>  </p>
3572  <p>Example:  <p>Example:
3573  </p>  </p>
# Line 3376  Intellectual Property and Copyright Stat Line 3577  Intellectual Property and Copyright Stat
3577  <p>  <p>
3578  </p>  </p>
3579  </blockquote><p>  </blockquote><p>
3580                        
3581  </p>  </p>
3582  <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 />
3583    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3584    <a name="rfc.section.6.4.6"></a><h3>6.4.6.&nbsp;
3585    Removing a sampler channel</h3>
3586    
3587  <p>A sampler channel can be removed by sending the following command:  <p>A sampler channel can be removed by sending the following command:
3588  </p>  </p>
# Line 3388  Intellectual Property and Copyright Stat Line 3592  Intellectual Property and Copyright Stat
3592  <p>REMOVE CHANNEL &lt;sampler-channel&gt;  <p>REMOVE CHANNEL &lt;sampler-channel&gt;
3593  </p>  </p>
3594  </blockquote><p>  </blockquote><p>
3595                        
3596  </p>  </p>
3597  <p>Where &lt;sampler-channel&gt; should be replaced by the  <p>Where &lt;sampler-channel&gt; should be replaced by the
3598                      number of the sampler channel as given by the                      number of the sampler channel as given by the
3599                      <a class="info" href="#ADD CHANNEL">"ADD CHANNEL"<span> (</span><span class="info">Adding a new sampler channel</span><span>)</span></a>                      <a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a>
3600                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a>                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a>
3601                      command. The channel numbers of all subsequent sampler channels                      command. The channel numbers of all subsequent sampler channels
3602                      remain the same.                      remain the same.
3603  </p>  </p>
# Line 3407  Intellectual Property and Copyright Stat Line 3611  Intellectual Property and Copyright Stat
3611  <blockquote class="text">  <blockquote class="text">
3612  <p>in case the given sampler channel could be removed  <p>in case the given sampler channel could be removed
3613  </p>  </p>
3614  </blockquote><p>  </blockquote>
3615                                
3616    
 </p>  
3617  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3618                                  </p>                                  </p>
3619  <blockquote class="text">  <blockquote class="text">
# Line 3417  Intellectual Property and Copyright Stat Line 3621  Intellectual Property and Copyright Stat
3621                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
3622                                      warning code and warning message                                      warning code and warning message
3623  </p>  </p>
3624  </blockquote><p>  </blockquote>
3625                                
3626    
 </p>  
3627  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3628                                  </p>                                  </p>
3629  <blockquote class="text">  <blockquote class="text">
3630  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
3631                                      error message                                      error message
3632  </p>  </p>
3633  </blockquote><p>  </blockquote>
3634                                
3635    
 </p>  
3636  </blockquote><p>  </blockquote><p>
3637                        
3638  </p>  </p>
3639  <p>Example:  <p>Example:
3640  </p>  </p>
# Line 3440  Intellectual Property and Copyright Stat Line 3644  Intellectual Property and Copyright Stat
3644  <p>  <p>
3645  </p>  </p>
3646  </blockquote><p>  </blockquote><p>
3647                        
3648  </p>  </p>
3649  <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 />
3650    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3651    <a name="rfc.section.6.4.7"></a><h3>6.4.7.&nbsp;
3652    Getting amount of available engines</h3>
3653    
3654  <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:
3655  </p>  </p>
# Line 3452  Intellectual Property and Copyright Stat Line 3659  Intellectual Property and Copyright Stat
3659  <p>GET AVAILABLE_ENGINES  <p>GET AVAILABLE_ENGINES
3660  </p>  </p>
3661  </blockquote><p>  </blockquote><p>
3662                        
3663  </p>  </p>
3664  <p>Possible Answers:  <p>Possible Answers:
3665  </p>  </p>
# Line 3462  Intellectual Property and Copyright Stat Line 3669  Intellectual Property and Copyright Stat
3669  <p>LinuxSampler will answer by sending the number of available engines.  <p>LinuxSampler will answer by sending the number of available engines.
3670  </p>  </p>
3671  </blockquote><p>  </blockquote><p>
3672                        
3673  </p>  </p>
3674  <p>Example:  <p>Example:
3675  </p>  </p>
# Line 3474  Intellectual Property and Copyright Stat Line 3681  Intellectual Property and Copyright Stat
3681  <p>S: "4"  <p>S: "4"
3682  </p>  </p>
3683  </blockquote><p>  </blockquote><p>
3684                        
3685  </p>  </p>
3686  <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 />
3687    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3688    <a name="rfc.section.6.4.8"></a><h3>6.4.8.&nbsp;
3689    Getting all available engines</h3>
3690    
3691  <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:
3692  </p>  </p>
# Line 3486  Intellectual Property and Copyright Stat Line 3696  Intellectual Property and Copyright Stat
3696  <p>LIST AVAILABLE_ENGINES  <p>LIST AVAILABLE_ENGINES
3697  </p>  </p>
3698  </blockquote><p>  </blockquote><p>
3699                        
3700  </p>  </p>
3701  <p>Possible Answers:  <p>Possible Answers:
3702  </p>  </p>
# Line 3499  Intellectual Property and Copyright Stat Line 3709  Intellectual Property and Copyright Stat
3709                              digits and underlines ("_" character).                              digits and underlines ("_" character).
3710  </p>  </p>
3711  </blockquote><p>  </blockquote><p>
3712                        
3713  </p>  </p>
3714  <p>Example:  <p>Example:
3715  </p>  </p>
# Line 3511  Intellectual Property and Copyright Stat Line 3721  Intellectual Property and Copyright Stat
3721  <p>S: "'GigEngine','AkaiEngine','DLSEngine','JoesCustomEngine'"  <p>S: "'GigEngine','AkaiEngine','DLSEngine','JoesCustomEngine'"
3722  </p>  </p>
3723  </blockquote><p>  </blockquote><p>
3724                        
3725  </p>  </p>
3726  <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 />
3727    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3728    <a name="rfc.section.6.4.9"></a><h3>6.4.9.&nbsp;
3729    Getting information about an engine</h3>
3730    
3731  <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
3732                      sending the following command:                      sending the following command:
# Line 3524  Intellectual Property and Copyright Stat Line 3737  Intellectual Property and Copyright Stat
3737  <p>GET ENGINE INFO &lt;engine-name&gt;  <p>GET ENGINE INFO &lt;engine-name&gt;
3738  </p>  </p>
3739  </blockquote><p>  </blockquote><p>
3740                        
3741  </p>  </p>
3742  <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
3743                      <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.
3744  </p>  </p>
3745  <p>Possible Answers:  <p>Possible Answers:
3746  </p>  </p>
# Line 3548  Intellectual Property and Copyright Stat Line 3761  Intellectual Property and Copyright Stat
3761  <blockquote class="text">  <blockquote class="text">
3762  <p>arbitrary description text about the engine  <p>arbitrary description text about the engine
3763  </p>  </p>
3764  </blockquote><p>  </blockquote>
3765                                        
3766    
 </p>  
3767  <p>VERSION -  <p>VERSION -
3768                                          </p>                                          </p>
3769  <blockquote class="text">  <blockquote class="text">
3770  <p>arbitrary character string regarding the engine's version  <p>arbitrary character string regarding the engine's version
3771  </p>  </p>
3772  </blockquote><p>  </blockquote>
3773                                        
3774    
3775  </p>  </blockquote>
3776  </blockquote><p>                              
3777    
 </p>  
3778  </blockquote><p>  </blockquote><p>
3779                        
3780  </p>  </p>
3781  <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.
3782  </p>  </p>
# Line 3581  Intellectual Property and Copyright Stat Line 3794  Intellectual Property and Copyright Stat
3794  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
3795  </p>  </p>
3796  </blockquote><p>  </blockquote><p>
3797                        
3798  </p>  </p>
3799  <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 />
3800    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3801    <a name="rfc.section.6.4.10"></a><h3>6.4.10.&nbsp;
3802    Getting sampler channel information</h3>
3803    
3804  <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
3805                      by sending the following command:                      by sending the following command:
# Line 3594  Intellectual Property and Copyright Stat Line 3810  Intellectual Property and Copyright Stat
3810  <p>GET CHANNEL INFO &lt;sampler-channel&gt;  <p>GET CHANNEL INFO &lt;sampler-channel&gt;
3811  </p>  </p>
3812  </blockquote><p>  </blockquote><p>
3813                        
3814  </p>  </p>
3815  <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
3816                      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>
3817                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command.                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command.
3818  </p>  </p>
3819  <p>Possible Answers:  <p>Possible Answers:
3820  </p>  </p>
# Line 3621  Intellectual Property and Copyright Stat Line 3837  Intellectual Property and Copyright Stat
3837                                              channel, "NONE" if there's no engine associated yet for                                              channel, "NONE" if there's no engine associated yet for
3838                                              this sampler channel                                              this sampler channel
3839  </p>  </p>
3840  </blockquote><p>  </blockquote>
3841                                        
3842    
 </p>  
3843  <p>AUDIO_OUTPUT_DEVICE -  <p>AUDIO_OUTPUT_DEVICE -
3844                                          </p>                                          </p>
3845  <blockquote class="text">  <blockquote class="text">
# Line 3632  Intellectual Property and Copyright Stat Line 3848  Intellectual Property and Copyright Stat
3848                                              the audio signal, "NONE" if there's no device                                              the audio signal, "NONE" if there's no device
3849                                              connected to this sampler channel                                              connected to this sampler channel
3850  </p>  </p>
3851  </blockquote><p>  </blockquote>
3852                                        
3853    
 </p>  
3854  <p>AUDIO_OUTPUT_CHANNELS -  <p>AUDIO_OUTPUT_CHANNELS -
3855                                          </p>                                          </p>
3856  <blockquote class="text">  <blockquote class="text">
3857  <p>number of output channels the sampler channel offers  <p>number of output channels the sampler channel offers
3858                                              (dependent to used sampler engine and loaded instrument)                                              (dependent to used sampler engine and loaded instrument)
3859  </p>  </p>
3860  </blockquote><p>  </blockquote>
3861                                        
3862    
 </p>  
3863  <p>AUDIO_OUTPUT_ROUTING -  <p>AUDIO_OUTPUT_ROUTING -
3864                                          </p>                                          </p>
3865  <blockquote class="text">  <blockquote class="text">
# Line 3655  Intellectual Property and Copyright Stat Line 3871  Intellectual Property and Copyright Stat
3871                                              channel 1 is routed to the channel 3 of the audio                                              channel 1 is routed to the channel 3 of the audio
3872                                              output device                                              output device
3873  </p>  </p>
3874  </blockquote><p>  </blockquote>
3875                                        
3876    
 </p>  
3877  <p>INSTRUMENT_FILE -  <p>INSTRUMENT_FILE -
3878                                          </p>                                          </p>
3879  <blockquote class="text">  <blockquote class="text">
# Line 3665  Intellectual Property and Copyright Stat Line 3881  Intellectual Property and Copyright Stat
3881                                              there's no instrument yet loaded for this sampler                                              there's no instrument yet loaded for this sampler
3882                                              channel                                              channel
3883  </p>  </p>
3884  </blockquote><p>  </blockquote>
3885                                        
3886    
 </p>  
3887  <p>INSTRUMENT_NR -  <p>INSTRUMENT_NR -
3888                                          </p>                                          </p>
3889  <blockquote class="text">  <blockquote class="text">
3890  <p>the instrument index number of the loaded instrument  <p>the instrument index number of the loaded instrument
3891  </p>  </p>
3892  </blockquote><p>  </blockquote>
3893                                        
3894    
 </p>  
3895  <p>INSTRUMENT_NAME -  <p>INSTRUMENT_NAME -
3896                                          </p>                                          </p>
3897  <blockquote class="text">  <blockquote class="text">
3898  <p>the instrument name of the loaded instrument  <p>the instrument name of the loaded instrument
3899  </p>  </p>
3900  </blockquote><p>  </blockquote>
3901                                        
3902    
 </p>  
3903  <p>INSTRUMENT_STATUS -  <p>INSTRUMENT_STATUS -
3904                                          </p>                                          </p>
3905  <blockquote class="text">  <blockquote class="text">
# Line 3691  Intellectual Property and Copyright Stat Line 3907  Intellectual Property and Copyright Stat
3907                                              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
3908                                              loaded.                                              loaded.
3909  </p>  </p>
3910  </blockquote><p>  </blockquote>
3911                                        
3912    
 </p>  
3913  <p>MIDI_INPUT_DEVICE -  <p>MIDI_INPUT_DEVICE -
3914                                          </p>                                          </p>
3915  <blockquote class="text">  <blockquote class="text">
# Line 3702  Intellectual Property and Copyright Stat Line 3918  Intellectual Property and Copyright Stat
3918                                              MIDI input commands, "NONE" if there's no device                                              MIDI input commands, "NONE" if there's no device
3919                                              connected to this sampler channel                                              connected to this sampler channel
3920  </p>  </p>
3921  </blockquote><p>  </blockquote>
3922                                        
3923    
 </p>  
3924  <p>MIDI_INPUT_PORT -  <p>MIDI_INPUT_PORT -
3925                                          </p>                                          </p>
3926  <blockquote class="text">  <blockquote class="text">
3927  <p>port number of the MIDI input device  <p>port number of the MIDI input device
3928  </p>  </p>
3929  </blockquote><p>  </blockquote>
3930                                        
3931    
 </p>  
3932  <p>MIDI_INPUT_CHANNEL -  <p>MIDI_INPUT_CHANNEL -
3933                                          </p>                                          </p>
3934  <blockquote class="text">  <blockquote class="text">
3935  <p>the MIDI input channel number this sampler channel  <p>the MIDI input channel number this sampler channel
3936                                              should listen to or "ALL" to listen on all MIDI channels                                              should listen to or "ALL" to listen on all MIDI channels
3937  </p>  </p>
3938  </blockquote><p>  </blockquote>
3939                                        
3940    
 </p>  
3941  <p>VOLUME -  <p>VOLUME -
3942                                          </p>                                          </p>
3943  <blockquote class="text">  <blockquote class="text">
# Line 3729  Intellectual Property and Copyright Stat Line 3945  Intellectual Property and Copyright Stat
3945                                              (where a value < 1.0 means attenuation and a value >                                              (where a value < 1.0 means attenuation and a value >
3946                                              1.0 means amplification)                                              1.0 means amplification)
3947  </p>  </p>
3948  </blockquote><p>  </blockquote>
3949                                        
3950    
 </p>  
3951  <p>MUTE -  <p>MUTE -
3952                                          </p>                                          </p>
3953  <blockquote class="text">  <blockquote class="text">
# Line 3741  Intellectual Property and Copyright Stat Line 3957  Intellectual Property and Copyright Stat
3957                                              presence of a solo channel and will be unmuted when                                              presence of a solo channel and will be unmuted when
3958                                              there are no solo channels left                                              there are no solo channels left
3959  </p>  </p>
3960  </blockquote><p>  </blockquote>
3961                                        
3962    
 </p>  
3963  <p>SOLO -  <p>SOLO -
3964                                          </p>                                          </p>
3965  <blockquote class="text">  <blockquote class="text">
3966  <p>Determines whether this is a solo channel, "true" if  <p>Determines whether this is a solo channel, "true" if
3967                                              the channel is a solo channel; "false" otherwise                                              the channel is a solo channel; "false" otherwise
3968  </p>  </p>
3969  </blockquote><p>  </blockquote>
3970                                        
3971    
3972    <p>MIDI_INSTRUMENT_MAP -
3973                                            </p>
3974    <blockquote class="text">
3975    <p>Determines to which MIDI instrument map this sampler
3976                                                channel is assigned to. Read chapter
3977                                                <a class='info' href='#SET CHANNEL MIDI_INSTRUMENT_MAP'>"SET CHANNEL MIDI_INSTRUMENT_MAP"<span> (</span><span class='info'>Assigning a MIDI instrument map to a sampler channel</span><span>)</span></a>
3978                                                for a list of possible values.
3979  </p>  </p>
3980  </blockquote><p>  </blockquote>
3981                                        
3982    
3983  </p>  </blockquote>
3984  </blockquote><p>                              
3985    
3986    </blockquote><p>
3987                        
3988  </p>  </p>
3989  <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.
3990  </p>  </p>
# Line 3792  Intellectual Property and Copyright Stat Line 4019  Intellectual Property and Copyright Stat
4019  </p>  </p>
4020  <p>&nbsp;&nbsp;&nbsp;"MIDI_INPUT_CHANNEL: 5"  <p>&nbsp;&nbsp;&nbsp;"MIDI_INPUT_CHANNEL: 5"
4021  </p>  </p>
4022    <p>&nbsp;&nbsp;&nbsp;"VOLUME: 1.0"
4023    </p>
4024    <p>&nbsp;&nbsp;&nbsp;"MUTE: false"
4025    </p>
4026    <p>&nbsp;&nbsp;&nbsp;"SOLO: false"
4027    </p>
4028    <p>&nbsp;&nbsp;&nbsp;"MIDI_INSTRUMENT_MAP: NONE"
4029    </p>
4030  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
4031  </p>  </p>
4032  </blockquote><p>  </blockquote><p>
4033                        
4034  </p>  </p>
4035  <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 />
4036    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4037    <a name="rfc.section.6.4.11"></a><h3>6.4.11.&nbsp;
4038    Current number of active voices</h3>
4039    
4040  <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
4041                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 3808  Intellectual Property and Copyright Stat Line 4046  Intellectual Property and Copyright Stat
4046  <p>GET CHANNEL VOICE_COUNT &lt;sampler-channel&gt;  <p>GET CHANNEL VOICE_COUNT &lt;sampler-channel&gt;
4047  </p>  </p>
4048  </blockquote><p>  </blockquote><p>
4049                        
4050  </p>  </p>
4051  <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
4052                      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>
4053                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command.                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command.
4054  </p>  </p>
4055  <p>Possible Answers:  <p>Possible Answers:
4056  </p>  </p>
# Line 3823  Intellectual Property and Copyright Stat Line 4061  Intellectual Property and Copyright Stat
4061                              voices on that channel.                              voices on that channel.
4062  </p>  </p>
4063  </blockquote><p>  </blockquote><p>
4064                        
4065  </p>  </p>
4066  <p>Example:  <p>Example:
4067  </p>  </p>
# Line 3833  Intellectual Property and Copyright Stat Line 4071  Intellectual Property and Copyright Stat
4071  <p>  <p>
4072  </p>  </p>
4073  </blockquote><p>  </blockquote><p>
4074                        
4075  </p>  </p>
4076  <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 />
4077    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4078    <a name="rfc.section.6.4.12"></a><h3>6.4.12.&nbsp;
4079    Current number of active disk streams</h3>
4080    
4081  <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
4082                      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 4087  Intellectual Property and Copyright Stat
4087  <p>GET CHANNEL STREAM_COUNT &lt;sampler-channel&gt;  <p>GET CHANNEL STREAM_COUNT &lt;sampler-channel&gt;
4088  </p>  </p>
4089  </blockquote><p>  </blockquote><p>
4090                        
4091  </p>  </p>
4092  <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
4093                      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>
4094                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command.                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command.
4095  </p>  </p>
4096  <p>Possible Answers:  <p>Possible Answers:
4097  </p>  </p>
# Line 3863  Intellectual Property and Copyright Stat Line 4104  Intellectual Property and Copyright Stat
4104                              return "NA" for not available.                              return "NA" for not available.
4105  </p>  </p>
4106  </blockquote><p>  </blockquote><p>
4107                        
4108  </p>  </p>
4109  <p>Example:  <p>Example:
4110  </p>  </p>
# Line 3873  Intellectual Property and Copyright Stat Line 4114  Intellectual Property and Copyright Stat
4114  <p>  <p>
4115  </p>  </p>
4116  </blockquote><p>  </blockquote><p>
4117                        
4118  </p>  </p>
4119  <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 />
4120    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4121    <a name="rfc.section.6.4.13"></a><h3>6.4.13.&nbsp;
4122    Current fill state of disk stream buffers</h3>
4123    
4124  <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
4125                      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 4130  Intellectual Property and Copyright Stat
4130  <p>GET CHANNEL BUFFER_FILL BYTES &lt;sampler-channel&gt;  <p>GET CHANNEL BUFFER_FILL BYTES &lt;sampler-channel&gt;
4131  </p>  </p>
4132  </blockquote><p>  </blockquote><p>
4133                        
4134  </p>  </p>
4135  <p>to get the fill state in bytes or  <p>to get the fill state in bytes or
4136  </p>  </p>
# Line 3896  Intellectual Property and Copyright Stat Line 4140  Intellectual Property and Copyright Stat
4140  <p>GET CHANNEL BUFFER_FILL PERCENTAGE &lt;sampler-channel&gt;  <p>GET CHANNEL BUFFER_FILL PERCENTAGE &lt;sampler-channel&gt;
4141  </p>  </p>
4142  </blockquote><p>  </blockquote><p>
4143                        
4144  </p>  </p>
4145  <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
4146                      sampler channel number the front-end is interested in                      sampler channel number the front-end is interested in
4147                      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>
4148                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command.                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command.
4149  </p>  </p>
4150  <p>Possible Answers:  <p>Possible Answers:
4151  </p>  </p>
# Line 3920  Intellectual Property and Copyright Stat Line 4164  Intellectual Property and Copyright Stat
4164                              to sort them by itself if necessary.                              to sort them by itself if necessary.
4165  </p>  </p>
4166  </blockquote><p>  </blockquote><p>
4167                        
4168  </p>  </p>
4169  <p>Examples:  <p>Examples:
4170  </p>  </p>
# Line 3948  Intellectual Property and Copyright Stat Line 4192  Intellectual Property and Copyright Stat
4192  <p>S: ""  <p>S: ""
4193  </p>  </p>
4194  </blockquote><p>  </blockquote><p>
4195                        
4196  </p>  </p>
4197  <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 />
4198    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4199    <a name="rfc.section.6.4.14"></a><h3>6.4.14.&nbsp;
4200    Setting audio output device</h3>
4201    
4202  <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
4203                      channel by sending the following command:                      channel by sending the following command:
# Line 3961  Intellectual Property and Copyright Stat Line 4208  Intellectual Property and Copyright Stat
4208  <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;
4209  </p>  </p>
4210  </blockquote><p>  </blockquote><p>
4211                        
4212  </p>  </p>
4213  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4214                      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>
4215                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command and                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command and
4216                      &lt;audio-device-id&gt; is the numerical ID of the audio output device as given by the                      &lt;audio-device-id&gt; is the numerical ID of the audio output device as given by the
4217                      <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>
4218                      or <a class="info" href="#LIST AUDIO_OUTPUT_DEVICES">"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class="info">Getting all created audio output device list</span><span>)</span></a>                      or <a class='info' href='#LIST AUDIO_OUTPUT_DEVICES'>"LIST AUDIO_OUTPUT_DEVICES"<span> (</span><span class='info'>Getting all created audio output device list</span><span>)</span></a>
4219                      command.                      command.
4220  </p>  </p>
4221  <p>Possible Answers:  <p>Possible Answers:
# Line 3981  Intellectual Property and Copyright Stat Line 4228  Intellectual Property and Copyright Stat
4228  <blockquote class="text">  <blockquote class="text">
4229  <p>on success  <p>on success
4230  </p>  </p>
4231  </blockquote><p>  </blockquote>
4232                                
4233    
 </p>  
4234  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4235                                  </p>                                  </p>
4236  <blockquote class="text">  <blockquote class="text">
# Line 3991  Intellectual Property and Copyright Stat Line 4238  Intellectual Property and Copyright Stat
4238                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4239                                      warning message                                      warning message
4240  </p>  </p>
4241  </blockquote><p>  </blockquote>
4242                                
4243    
 </p>  
4244  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4245                                  </p>                                  </p>
4246  <blockquote class="text">  <blockquote class="text">
4247  <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
4248  </p>  </p>
4249  </blockquote><p>  </blockquote>
4250                                
4251    
 </p>  
4252  </blockquote><p>  </blockquote><p>
4253                        
4254  </p>  </p>
4255  <p>Examples:  <p>Examples:
4256  </p>  </p>
# Line 4013  Intellectual Property and Copyright Stat Line 4260  Intellectual Property and Copyright Stat
4260  <p>  <p>
4261  </p>  </p>
4262  </blockquote><p>  </blockquote><p>
4263                        
4264  </p>  </p>
4265  <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_TYPE"></a><br /><hr />
4266    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4267    <a name="rfc.section.6.4.15"></a><h3>6.4.15.&nbsp;
4268    Setting audio output type</h3>
4269    
4270  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4271  </p>  </p>
# Line 4028  Intellectual Property and Copyright Stat Line 4278  Intellectual Property and Copyright Stat
4278  <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;
4279  </p>  </p>
4280  </blockquote><p>  </blockquote><p>
4281                        
4282  </p>  </p>
4283  <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
4284                      &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 4293  Intellectual Property and Copyright Stat
4293  <blockquote class="text">  <blockquote class="text">
4294  <p>on success  <p>on success
4295  </p>  </p>
4296  </blockquote><p>  </blockquote>
4297                                
4298    
 </p>  
4299  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4300                                  </p>                                  </p>
4301  <blockquote class="text">  <blockquote class="text">
# Line 4053  Intellectual Property and Copyright Stat Line 4303  Intellectual Property and Copyright Stat
4303                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4304                                      warning message                                      warning message
4305  </p>  </p>
4306  </blockquote><p>  </blockquote>
4307                                
4308    
 </p>  
4309  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4310                                  </p>                                  </p>
4311  <blockquote class="text">  <blockquote class="text">
4312  <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
4313  </p>  </p>
4314  </blockquote><p>  </blockquote>
4315                                
4316    
 </p>  
4317  </blockquote><p>  </blockquote><p>
4318                        
4319  </p>  </p>
4320  <p>Examples:  <p>Examples:
4321  </p>  </p>
# Line 4075  Intellectual Property and Copyright Stat Line 4325  Intellectual Property and Copyright Stat
4325  <p>  <p>
4326  </p>  </p>
4327  </blockquote><p>  </blockquote><p>
4328                        
4329  </p>  </p>
4330  <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 />
4331    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4332    <a name="rfc.section.6.4.16"></a><h3>6.4.16.&nbsp;
4333    Setting audio output channel</h3>
4334    
4335  <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
4336                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 4088  Intellectual Property and Copyright Stat Line 4341  Intellectual Property and Copyright Stat
4341  <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;
4342  </p>  </p>
4343  </blockquote><p>  </blockquote><p>
4344                        
4345  </p>  </p>
4346  <p>Where &lt;sampler-chan&gt; is the sampler channel number  <p>Where &lt;sampler-chan&gt; is the sampler channel number
4347                      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>
4348                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command, &lt;audio-out&gt; is the                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command, &lt;audio-out&gt; is the
4349                      numerical ID of the sampler channel's audio output channel which should be                      numerical ID of the sampler channel's audio output channel which should be
4350                      rerouted and &lt;audio-in&gt; is the numerical ID of the audio channel of the selected audio                      rerouted and &lt;audio-in&gt; is the numerical ID of the audio channel of the selected audio
4351                      output device where &lt;audio-out&gt; should be routed to.                      output device where &lt;audio-out&gt; should be routed to.
# Line 4107  Intellectual Property and Copyright Stat Line 4360  Intellectual Property and Copyright Stat
4360  <blockquote class="text">  <blockquote class="text">
4361  <p>on success  <p>on success
4362  </p>  </p>
4363  </blockquote><p>  </blockquote>
4364                                
4365    
 </p>  
4366  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4367                                  </p>                                  </p>
4368  <blockquote class="text">  <blockquote class="text">
# Line 4117  Intellectual Property and Copyright Stat Line 4370  Intellectual Property and Copyright Stat
4370                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4371                                      warning message                                      warning message
4372  </p>  </p>
4373  </blockquote><p>  </blockquote>
4374                                
4375    
 </p>  
4376  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4377                                  </p>                                  </p>
4378  <blockquote class="text">  <blockquote class="text">
4379  <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
4380  </p>  </p>
4381  </blockquote><p>  </blockquote>
4382                                
4383    
 </p>  
4384  </blockquote><p>  </blockquote><p>
4385                        
4386  </p>  </p>
4387  <p>Examples:  <p>Examples:
4388  </p>  </p>
# Line 4139  Intellectual Property and Copyright Stat Line 4392  Intellectual Property and Copyright Stat
4392  <p>  <p>
4393  </p>  </p>
4394  </blockquote><p>  </blockquote><p>
4395                        
4396  </p>  </p>
4397  <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 />
4398    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4399    <a name="rfc.section.6.4.17"></a><h3>6.4.17.&nbsp;
4400    Setting MIDI input device</h3>
4401    
4402  <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
4403                      channel by sending the following command:                      channel by sending the following command:
# Line 4152  Intellectual Property and Copyright Stat Line 4408  Intellectual Property and Copyright Stat
4408  <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;
4409  </p>  </p>
4410  </blockquote><p>  </blockquote><p>
4411                        
4412  </p>  </p>
4413  <p>Where &lt;sampler-channel&gt; is the sampler channel number  <p>Where &lt;sampler-channel&gt; is the sampler channel number
4414                      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>
4415                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command
4416                      and &lt;midi-device-id&gt; is  the numerical ID of the MIDI input device as returned by the                      and &lt;midi-device-id&gt; is  the numerical ID of the MIDI input device as returned by the
4417                      <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>
4418                      or <a class="info" href="#LIST MIDI_INPUT_DEVICES">"LIST MIDI_INPUT_DEVICES"<span> (</span><span class="info">Getting all created MIDI input device list</span><span>)</span></a> command.                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a> command.
4419  </p>  </p>
4420  <p>Possible Answers:  <p>Possible Answers:
4421  </p>  </p>
# Line 4171  Intellectual Property and Copyright Stat Line 4427  Intellectual Property and Copyright Stat
4427  <blockquote class="text">  <blockquote class="text">
4428  <p>on success  <p>on success
4429  </p>  </p>
4430  </blockquote><p>  </blockquote>
4431                                
4432    
 </p>  
4433  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4434                                  </p>                                  </p>
4435  <blockquote class="text">  <blockquote class="text">
# Line 4181  Intellectual Property and Copyright Stat Line 4437  Intellectual Property and Copyright Stat
4437                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4438                                      warning message                                      warning message
4439  </p>  </p>
4440  </blockquote><p>  </blockquote>
4441                                
4442    
 </p>  
4443  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4444                                  </p>                                  </p>
4445  <blockquote class="text">  <blockquote class="text">
4446  <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
4447  </p>  </p>
4448  </blockquote><p>  </blockquote>
4449                                
4450    
 </p>  
4451  </blockquote><p>  </blockquote><p>
4452                        
4453  </p>  </p>
4454  <p>Examples:  <p>Examples:
4455  </p>  </p>
# Line 4203  Intellectual Property and Copyright Stat Line 4459  Intellectual Property and Copyright Stat
4459  <p>  <p>
4460  </p>  </p>
4461  </blockquote><p>  </blockquote><p>
4462                        
4463  </p>  </p>
4464  <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 />
4465    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4466    <a name="rfc.section.6.4.18"></a><h3>6.4.18.&nbsp;
4467    Setting MIDI input type</h3>
4468    
4469  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4470  </p>  </p>
# Line 4218  Intellectual Property and Copyright Stat Line 4477  Intellectual Property and Copyright Stat
4477  <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;
4478  </p>  </p>
4479  </blockquote><p>  </blockquote><p>
4480                        
4481  </p>  </p>
4482  <p>Where &lt;midi-input-type&gt; is currently only "ALSA" and  <p>Where &lt;midi-input-type&gt; is currently only "ALSA" and
4483                      &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 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 4243  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 4265  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.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 />
4530    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4531    <a name="rfc.section.6.4.19"></a><h3>6.4.19.&nbsp;
4532    Setting MIDI input port</h3>
4533    
4534  <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
4535                      channel by sending the following command:                      channel by sending the following command:
# Line 4278  Intellectual Property and Copyright Stat Line 4540  Intellectual Property and Copyright Stat
4540  <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;
4541  </p>  </p>
4542  </blockquote><p>  </blockquote><p>
4543                        
4544  </p>  </p>
4545  <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
4546                      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 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 4304  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 4326  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.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 />
4594    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4595    <a name="rfc.section.6.4.20"></a><h3>6.4.20.&nbsp;
4596    Setting MIDI input channel</h3>
4597    
4598  <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
4599                      listen to by sending the following command:                      listen to by sending the following command:
# Line 4339  Intellectual Property and Copyright Stat Line 4604  Intellectual Property and Copyright Stat
4604  <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;
4605  </p>  </p>
4606  </blockquote><p>  </blockquote><p>
4607                        
4608  </p>  </p>
4609  <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
4610                      &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 4620  Intellectual Property and Copyright Stat
4620  <blockquote class="text">  <blockquote class="text">
4621  <p>on success  <p>on success
4622  </p>  </p>
4623  </blockquote><p>  </blockquote>
4624                                
4625    
 </p>  
4626  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4627                                  </p>                                  </p>
4628  <blockquote class="text">  <blockquote class="text">
# Line 4365  Intellectual Property and Copyright Stat Line 4630  Intellectual Property and Copyright Stat
4630                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4631                                      warning message                                      warning message
4632  </p>  </p>
4633  </blockquote><p>  </blockquote>
4634                                
4635    
 </p>  
4636  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4637                                  </p>                                  </p>
4638  <blockquote class="text">  <blockquote class="text">
4639  <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
4640  </p>  </p>
4641  </blockquote><p>  </blockquote>
4642                                
4643    
 </p>  
4644  </blockquote><p>  </blockquote><p>
4645                        
4646  </p>  </p>
4647  <p>Examples:  <p>Examples:
4648  </p>  </p>
# Line 4387  Intellectual Property and Copyright Stat Line 4652  Intellectual Property and Copyright Stat
4652  <p>  <p>
4653  </p>  </p>
4654  </blockquote><p>  </blockquote><p>
4655                        
4656  </p>  </p>
4657  <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 />
4658    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4659    <a name="rfc.section.6.4.21"></a><h3>6.4.21.&nbsp;
4660    Setting channel volume</h3>
4661    
4662  <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
4663                      the following command:                      the following command:
# Line 4400  Intellectual Property and Copyright Stat Line 4668  Intellectual Property and Copyright Stat
4668  <p>SET CHANNEL VOLUME &lt;sampler-channel&gt; &lt;volume&gt;  <p>SET CHANNEL VOLUME &lt;sampler-channel&gt; &lt;volume&gt;
4669  </p>  </p>
4670  </blockquote><p>  </blockquote><p>
4671                        
4672  </p>  </p>
4673  <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
4674                      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 4685  Intellectual Property and Copyright Stat
4685  <blockquote class="text">  <blockquote class="text">
4686  <p>on success  <p>on success
4687  </p>  </p>
4688  </blockquote><p>  </blockquote>
4689                                
4690    
 </p>  
4691  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4692                                  </p>                                  </p>
4693  <blockquote class="text">  <blockquote class="text">
# Line 4427  Intellectual Property and Copyright Stat Line 4695  Intellectual Property and Copyright Stat
4695                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4696                                      warning message                                      warning message
4697  </p>  </p>
4698  </blockquote><p>  </blockquote>
4699                                
4700    
 </p>  
4701  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4702                                  </p>                                  </p>
4703  <blockquote class="text">  <blockquote class="text">
4704  <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
4705  </p>  </p>
4706  </blockquote><p>  </blockquote>
4707                                
4708    
 </p>  
4709  </blockquote><p>  </blockquote><p>
4710                        
4711  </p>  </p>
4712  <p>Examples:  <p>Examples:
4713  </p>  </p>
# Line 4449  Intellectual Property and Copyright Stat Line 4717  Intellectual Property and Copyright Stat
4717  <p>  <p>
4718  </p>  </p>
4719  </blockquote><p>  </blockquote><p>
4720                        
4721  </p>  </p>
4722  <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 />
4723    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4724    <a name="rfc.section.6.4.22"></a><h3>6.4.22.&nbsp;
4725    Muting a sampler channel</h3>
4726    
4727  <p>The front-end can mute/unmute a specific sampler  <p>The front-end can mute/unmute a specific sampler
4728                      channel by sending the following command:                      channel by sending the following command:
# Line 4462  Intellectual Property and Copyright Stat Line 4733  Intellectual Property and Copyright Stat
4733  <p>SET CHANNEL MUTE &lt;sampler-channel&gt; &lt;mute&gt;  <p>SET CHANNEL MUTE &lt;sampler-channel&gt; &lt;mute&gt;
4734  </p>  </p>
4735  </blockquote><p>  </blockquote><p>
4736                        
4737  </p>  </p>
4738  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4739                      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>
4740                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command and                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command and
4741                      &lt;mute&gt; should be replaced either by "1" to mute the channel or "0"                      &lt;mute&gt; should be replaced either by "1" to mute the channel or "0"
4742                      to unmute the channel.                      to unmute the channel.
4743  </p>  </p>
# Line 4480  Intellectual Property and Copyright Stat Line 4751  Intellectual Property and Copyright Stat
4751  <blockquote class="text">  <blockquote class="text">
4752  <p>on success  <p>on success
4753  </p>  </p>
4754  </blockquote><p>  </blockquote>
4755                                
4756    
 </p>  
4757  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4758                                  </p>                                  </p>
4759  <blockquote class="text">  <blockquote class="text">
# Line 4490  Intellectual Property and Copyright Stat Line 4761  Intellectual Property and Copyright Stat
4761                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4762                                      warning message                                      warning message
4763  </p>  </p>
4764  </blockquote><p>  </blockquote>
4765                                
4766    
 </p>  
4767  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4768                                  </p>                                  </p>
4769  <blockquote class="text">  <blockquote class="text">
4770  <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
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 4512  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.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 />
4789    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4790    <a name="rfc.section.6.4.23"></a><h3>6.4.23.&nbsp;
4791    Soloing a sampler channel</h3>
4792    
4793  <p>The front-end can solo/unsolo a specific sampler channel  <p>The front-end can solo/unsolo a specific sampler channel
4794                      by sending the following command:                      by sending the following command:
# Line 4525  Intellectual Property and Copyright Stat Line 4799  Intellectual Property and Copyright Stat
4799  <p>SET CHANNEL SOLO &lt;sampler-channel&gt; &lt;solo&gt;  <p>SET CHANNEL SOLO &lt;sampler-channel&gt; &lt;solo&gt;
4800  </p>  </p>
4801  </blockquote><p>  </blockquote><p>
4802                        
4803  </p>  </p>
4804  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4805                      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>
4806                      or <a class="info" href="#LIST CHANNELS">"LIST CHANNELS"<span> (</span><span class="info">Getting all created sampler channel list</span><span>)</span></a> command and                      or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command and
4807                      &lt;solo&gt; should be replaced either by "1" to solo the channel or "0"                      &lt;solo&gt; should be replaced either by "1" to solo the channel or "0"
4808                      to unsolo the channel.                      to unsolo the channel.
4809  </p>  </p>
# Line 4543  Intellectual Property and Copyright Stat Line 4817  Intellectual Property and Copyright Stat
4817  <blockquote class="text">  <blockquote class="text">
4818  <p>on success  <p>on success
4819  </p>  </p>
4820  </blockquote><p>  </blockquote>
4821                                
4822    
 </p>  
4823  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4824                                  </p>                                  </p>
4825  <blockquote class="text">  <blockquote class="text">
# Line 4553  Intellectual Property and Copyright Stat Line 4827  Intellectual Property and Copyright Stat
4827                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4828                                      warning message                                      warning message
4829  </p>  </p>
4830  </blockquote><p>  </blockquote>
4831                                
4832    
 </p>  
4833  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4834                                  </p>                                  </p>
4835  <blockquote class="text">  <blockquote class="text">
4836  <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
4837  </p>  </p>
4838    </blockquote>
4839                                
4840    
4841    </blockquote><p>
4842                        
4843    </p>
4844    <p>Examples:
4845    </p>
4846    <p>
4847                            </p>
4848    <blockquote class="text">
4849    <p>
4850    </p>
4851  </blockquote><p>  </blockquote><p>
4852                        
4853    </p>
4854    <a name="SET CHANNEL MIDI_INSTRUMENT_MAP"></a><br /><hr />
4855    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4856    <a name="rfc.section.6.4.24"></a><h3>6.4.24.&nbsp;
4857    Assigning a MIDI instrument map to a sampler channel</h3>
4858    
4859    <p>The front-end can assign a MIDI instrument map to a specific sampler channel
4860                        by sending the following command:
4861  </p>  </p>
4862    <p>
4863                            </p>
4864    <blockquote class="text">
4865    <p>SET CHANNEL MIDI_INSTRUMENT_MAP &lt;sampler-channel&gt; &lt;map&gt;
4866    </p>
4867    </blockquote><p>
4868                        
4869    </p>
4870    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4871                        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>
4872                        or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command and
4873                        &lt;map&gt; can have the following possibilites:
4874    </p>
4875    <p>
4876                            </p>
4877    <blockquote class="text">
4878    <p>"NONE" -
4879                                    </p>
4880    <blockquote class="text">
4881    <p>This is the default setting. In this case
4882                                        the sampler channel is not assigned any MIDI
4883                                        instrument map and thus will ignore all MIDI
4884                                        program change messages.
4885    </p>
4886    </blockquote>
4887                                
4888    
4889    <p>"DEFAULT" -
4890                                    </p>
4891    <blockquote class="text">
4892    <p>The sampler channel will always use the
4893                                        default MIDI instrument map to handle MIDI
4894                                        program change messages.
4895    </p>
4896    </blockquote>
4897                                
4898    
4899    <p>numeric ID -
4900                                    </p>
4901    <blockquote class="text">
4902    <p>You can assign a specific MIDI instrument map
4903                                        by replacing &lt;map&gt; with the respective numeric
4904                                        ID of the MIDI instrument map as returned by the
4905                                        <a class='info' href='#LIST MIDI_INSTRUMENT_MAPS'>"LIST MIDI_INSTRUMENT_MAPS"<span> (</span><span class='info'>Getting all created MIDI instrument maps</span><span>)</span></a>
4906                                        command. Once that map will be deleted, the sampler
4907                                        channel would fall back to "NONE".
4908    </p>
4909    </blockquote>
4910                                
4911    
4912  </blockquote><p>  </blockquote><p>
4913                        
4914    </p>
4915    <p>Read chapter <a class='info' href='#MIDI Instrument Mapping'>"MIDI Instrument Mapping"<span> (</span><span class='info'>MIDI Instrument Mapping</span><span>)</span></a>
4916                        for details regarding MIDI instrument mapping.
4917    </p>
4918    <p>Possible Answers:
4919    </p>
4920    <p>
4921                            </p>
4922    <blockquote class="text">
4923    <p>"OK" -
4924                                    </p>
4925    <blockquote class="text">
4926    <p>on success
4927    </p>
4928    </blockquote>
4929                                
4930    
4931    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4932                                    </p>
4933    <blockquote class="text">
4934    <p>in case it failed, providing an appropriate error code and error message
4935    </p>
4936    </blockquote>
4937                                
4938    
4939    </blockquote><p>
4940                        
4941  </p>  </p>
4942  <p>Examples:  <p>Examples:
4943  </p>  </p>
# Line 4575  Intellectual Property and Copyright Stat Line 4947  Intellectual Property and Copyright Stat
4947  <p>  <p>
4948  </p>  </p>
4949  </blockquote><p>  </blockquote><p>
4950                        
4951  </p>  </p>
4952  <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 />
4953    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4954    <a name="rfc.section.6.4.25"></a><h3>6.4.25.&nbsp;
4955    Resetting a sampler channel</h3>
4956    
4957  <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:
4958  </p>  </p>
# Line 4587  Intellectual Property and Copyright Stat Line 4962  Intellectual Property and Copyright Stat
4962  <p>RESET CHANNEL &lt;sampler-channel&gt;  <p>RESET CHANNEL &lt;sampler-channel&gt;
4963  </p>  </p>
4964  </blockquote><p>  </blockquote><p>
4965                        
4966  </p>  </p>
4967  <p>  <p>
4968                      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 4980  Intellectual Property and Copyright Stat
4980  <blockquote class="text">  <blockquote class="text">
4981  <p>on success  <p>on success
4982  </p>  </p>
4983  </blockquote><p>  </blockquote>
4984                                
4985    
 </p>  
4986  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4987                                  </p>                                  </p>
4988  <blockquote class="text">  <blockquote class="text">
# Line 4615  Intellectual Property and Copyright Stat Line 4990  Intellectual Property and Copyright Stat
4990                                      related, providing an appropriate warning code and warning                                      related, providing an appropriate warning code and warning
4991                                      message                                      message
4992  </p>  </p>
4993  </blockquote><p>  </blockquote>
4994                                
4995    
 </p>  
4996  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4997                                  </p>                                  </p>
4998  <blockquote class="text">  <blockquote class="text">
4999  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
5000                                      error message                                      error message
5001  </p>  </p>
5002  </blockquote><p>  </blockquote>
5003                                
5004    
 </p>  
5005  </blockquote><p>  </blockquote><p>
5006                        
5007  </p>  </p>
5008  <p>Examples:  <p>Examples:
5009  </p>  </p>
# Line 4638  Intellectual Property and Copyright Stat Line 5013  Intellectual Property and Copyright Stat
5013  <p>  <p>
5014  </p>  </p>
5015  </blockquote><p>  </blockquote><p>
5016                        
5017  </p>  </p>
5018  <a name="rfc.section.6.5"></a><h4><a name="anchor12">6.5</a>&nbsp;Controlling connection</h4>  <a name="anchor12"></a><br /><hr />
5019    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5020    <a name="rfc.section.6.5"></a><h3>6.5.&nbsp;
5021    Controlling connection</h3>
5022    
5023  <p>The following commands are used to control the connection to LinuxSampler.  <p>The following commands are used to control the connection to LinuxSampler.
5024  </p>  </p>
5025  <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 />
5026    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5027    <a name="rfc.section.6.5.1"></a><h3>6.5.1.&nbsp;
5028    Register front-end for receiving event messages</h3>
5029    
5030  <p>The front-end can register itself to the LinuxSampler application to  <p>The front-end can register itself to the LinuxSampler application to
5031                      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 5036  Intellectual Property and Copyright Stat
5036  <p>SUBSCRIBE &lt;event-id&gt;  <p>SUBSCRIBE &lt;event-id&gt;
5037  </p>  </p>
5038  </blockquote><p>  </blockquote><p>
5039                        
5040  </p>  </p>
5041  <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
5042                      client wants to subscribe to.                      client wants to subscribe to.
# Line 4670  Intellectual Property and Copyright Stat Line 5051  Intellectual Property and Copyright Stat
5051  <blockquote class="text">  <blockquote class="text">
5052  <p>on success  <p>on success
5053  </p>  </p>
5054  </blockquote><p>  </blockquote>
5055                                
5056    
 </p>  
5057  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5058                                  </p>                                  </p>
5059  <blockquote class="text">  <blockquote class="text">
# Line 4680  Intellectual Property and Copyright Stat Line 5061  Intellectual Property and Copyright Stat
5061                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
5062                                      warning message                                      warning message
5063  </p>  </p>
5064  </blockquote><p>  </blockquote>
5065                                
5066    
 </p>  
5067  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5068                                  </p>                                  </p>
5069  <blockquote class="text">  <blockquote class="text">
5070  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
5071                                      error message                                      error message
5072  </p>  </p>
5073  </blockquote><p>  </blockquote>
5074                                
5075    
 </p>  
5076  </blockquote><p>  </blockquote><p>
5077                        
5078  </p>  </p>
5079  <p>Examples:  <p>Examples:
5080  </p>  </p>
# Line 4703  Intellectual Property and Copyright Stat Line 5084  Intellectual Property and Copyright Stat
5084  <p>  <p>
5085  </p>  </p>
5086  </blockquote><p>  </blockquote><p>
5087                        
5088  </p>  </p>
5089  <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 />
5090    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5091    <a name="rfc.section.6.5.2"></a><h3>6.5.2.&nbsp;
5092    Unregister front-end for not receiving event messages</h3>
5093    
5094  <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
5095                      messages anymore by sending the following command:                      messages anymore by sending the following command:
# Line 4716  Intellectual Property and Copyright Stat Line 5100  Intellectual Property and Copyright Stat
5100  <p>UNSUBSCRIBE &lt;event-id&gt;  <p>UNSUBSCRIBE &lt;event-id&gt;
5101  </p>  </p>
5102  </blockquote><p>  </blockquote><p>
5103                        
5104  </p>  </p>
5105  <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
5106                      client doesn't want to receive anymore.                      client doesn't want to receive anymore.
# Line 4731  Intellectual Property and Copyright Stat Line 5115  Intellectual Property and Copyright Stat
5115  <blockquote class="text">  <blockquote class="text">
5116  <p>on success  <p>on success
5117  </p>  </p>
5118  </blockquote><p>  </blockquote>
5119                                
5120    
 </p>  
5121  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5122                                  </p>                                  </p>
5123  <blockquote class="text">  <blockquote class="text">
# Line 4741  Intellectual Property and Copyright Stat Line 5125  Intellectual Property and Copyright Stat
5125                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
5126                                      warning message                                      warning message
5127  </p>  </p>
5128  </blockquote><p>  </blockquote>
5129                                
5130    
 </p>  
5131  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5132                                  </p>                                  </p>
5133  <blockquote class="text">  <blockquote class="text">
5134  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
5135                                      error message                                      error message
5136  </p>  </p>
5137  </blockquote><p>  </blockquote>
5138                                
5139    
 </p>  
5140  </blockquote><p>  </blockquote><p>
5141                        
5142  </p>  </p>
5143  <p>Examples:  <p>Examples:
5144  </p>  </p>
# Line 4764  Intellectual Property and Copyright Stat Line 5148  Intellectual Property and Copyright Stat
5148  <p>  <p>
5149  </p>  </p>
5150  </blockquote><p>  </blockquote><p>
5151                        
5152  </p>  </p>
5153  <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 />
5154    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5155    <a name="rfc.section.6.5.3"></a><h3>6.5.3.&nbsp;
5156    Enable or disable echo of commands</h3>
5157    
5158  <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:
5159  </p>  </p>
# Line 4776  Intellectual Property and Copyright Stat Line 5163  Intellectual Property and Copyright Stat
5163  <p>SET ECHO &lt;value&gt;  <p>SET ECHO &lt;value&gt;
5164  </p>  </p>
5165  </blockquote><p>  </blockquote><p>
5166                        
5167  </p>  </p>
5168  <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
5169                      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 5183  Intellectual Property and Copyright Stat
5183  <blockquote class="text">  <blockquote class="text">
5184  <p>usually  <p>usually
5185  </p>  </p>
5186  </blockquote><p>  </blockquote>
5187                                
5188    
 </p>  
5189  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5190                                  </p>                                  </p>
5191  <blockquote class="text">  <blockquote class="text">
5192  <p>on syntax error, e.g. non boolean value  <p>on syntax error, e.g. non boolean value
5193  </p>  </p>
5194  </blockquote><p>  </blockquote>
5195                                
5196    
 </p>  
5197  </blockquote><p>  </blockquote><p>
5198                        
5199  </p>  </p>
5200  <p>Examples:  <p>Examples:
5201  </p>  </p>
# Line 4818  Intellectual Property and Copyright Stat Line 5205  Intellectual Property and Copyright Stat
5205  <p>  <p>
5206  </p>  </p>
5207  </blockquote><p>  </blockquote><p>
5208                        
5209  </p>  </p>
5210  <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 />
5211    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5212    <a name="rfc.section.6.5.4"></a><h3>6.5.4.&nbsp;
5213    Close client connection</h3>
5214    
5215  <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:
5216  </p>  </p>
# Line 4830  Intellectual Property and Copyright Stat Line 5220  Intellectual Property and Copyright Stat
5220  <p>QUIT  <p>QUIT
5221  </p>  </p>
5222  </blockquote><p>  </blockquote><p>
5223                        
5224  </p>  </p>
5225  <p>This is probably more interesting for manual telnet connections to  <p>This is probably more interesting for manual telnet connections to
5226                      LinuxSampler than really useful for a front-end implementation.                      LinuxSampler than really useful for a front-end implementation.
5227  </p>  </p>
5228  <a name="rfc.section.6.6"></a><h4><a name="anchor13">6.6</a>&nbsp;Global commands</h4>  <a name="anchor13"></a><br /><hr />
5229    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5230    <a name="rfc.section.6.6"></a><h3>6.6.&nbsp;
5231    Global commands</h3>
5232    
5233  <p>The following commands have global impact on the sampler.  <p>The following commands have global impact on the sampler.
5234  </p>  </p>
5235  <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 />
5236    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5237    <a name="rfc.section.6.6.1"></a><h3>6.6.1.&nbsp;
5238    Current number of active voices</h3>
5239    
5240    <p>The front-end can ask for the current number of active voices on
5241                        the sampler by sending the following command:
5242    </p>
5243    <p>
5244                            </p>
5245    <blockquote class="text">
5246    <p>GET TOTAL_VOICE_COUNT
5247    </p>
5248    </blockquote><p>
5249                        
5250    </p>
5251    <p>Possible Answers:
5252    </p>
5253    <p>
5254                            </p>
5255    <blockquote class="text">
5256    <p>LinuxSampler will answer by returning the number of all active
5257                                voices on the sampler.
5258    </p>
5259    </blockquote><p>
5260                        
5261    </p>
5262    <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />
5263    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5264    <a name="rfc.section.6.6.2"></a><h3>6.6.2.&nbsp;
5265    Maximum amount of active voices</h3>
5266    
5267    <p>The front-end can ask for the maximum number of active voices
5268                        by sending the following command:
5269    </p>
5270    <p>
5271                            </p>
5272    <blockquote class="text">
5273    <p>GET TOTAL_VOICE_COUNT_MAX
5274    </p>
5275    </blockquote><p>
5276                        
5277    </p>
5278    <p>Possible Answers:
5279    </p>
5280    <p>
5281                            </p>
5282    <blockquote class="text">
5283    <p>LinuxSampler will answer by returning the maximum number
5284                                of active voices.
5285    </p>
5286    </blockquote><p>
5287                        
5288    </p>
5289    <a name="RESET"></a><br /><hr />
5290    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5291    <a name="rfc.section.6.6.3"></a><h3>6.6.3.&nbsp;
5292    Reset sampler</h3>
5293    
5294  <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:
5295  </p>  </p>
# Line 4849  Intellectual Property and Copyright Stat Line 5299  Intellectual Property and Copyright Stat
5299  <p>RESET  <p>RESET
5300  </p>  </p>
5301  </blockquote><p>  </blockquote><p>
5302                        
5303  </p>  </p>
5304  <p>Possible Answers:  <p>Possible Answers:
5305  </p>  </p>
# Line 4861  Intellectual Property and Copyright Stat Line 5311  Intellectual Property and Copyright Stat
5311  <blockquote class="text">  <blockquote class="text">
5312  <p>always  <p>always
5313  </p>  </p>
5314  </blockquote><p>  </blockquote>
5315                                
5316    
 </p>  
5317  </blockquote><p>  </blockquote><p>
5318                        
5319  </p>  </p>
5320  <p>Examples:  <p>Examples:
5321  </p>  </p>
# Line 4875  Intellectual Property and Copyright Stat Line 5325  Intellectual Property and Copyright Stat
5325  <p>  <p>
5326  </p>  </p>
5327  </blockquote><p>  </blockquote><p>
5328                        
5329  </p>  </p>
5330  <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 />
5331    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5332    <a name="rfc.section.6.6.4"></a><h3>6.6.4.&nbsp;
5333    General sampler informations</h3>
5334    
5335  <p>The client can ask for general informations about the LinuxSampler  <p>The client can ask for general informations about the LinuxSampler
5336                         instance by sending the following command:                         instance by sending the following command:
# Line 4888  Intellectual Property and Copyright Stat Line 5341  Intellectual Property and Copyright Stat
5341  <p>GET SERVER INFO  <p>GET SERVER INFO
5342  </p>  </p>
5343  </blockquote><p>  </blockquote><p>
5344                        
5345  </p>  </p>
5346  <p>Possible Answers:  <p>Possible Answers:
5347  </p>  </p>
# Line 4900  Intellectual Property and Copyright Stat Line 5353  Intellectual Property and Copyright Stat
5353                                 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
5354                                 the info character string to that information category. At the                                 the info character string to that information category. At the
5355                                 moment the following categories are defined:                                 moment the following categories are defined:
5356                                
5357  </p>  </p>
5358  <p>  <p>
5359                                  </p>                                  </p>
# Line 4910  Intellectual Property and Copyright Stat Line 5363  Intellectual Property and Copyright Stat
5363  <blockquote class="text">  <blockquote class="text">
5364  <p>arbitrary textual description about the sampler  <p>arbitrary textual description about the sampler
5365  </p>  </p>
5366  </blockquote><p>  </blockquote>
5367                                        
5368    
 </p>  
5369  <p>VERSION -  <p>VERSION -
5370                                          </p>                                          </p>
5371  <blockquote class="text">  <blockquote class="text">
5372  <p>version of the sampler  <p>version of the sampler
5373  </p>  </p>
5374  </blockquote><p>  </blockquote>
5375                                        
5376    
 </p>  
5377  <p>PROTOCOL_VERSION -  <p>PROTOCOL_VERSION -
5378                                          </p>                                          </p>
5379  <blockquote class="text">  <blockquote class="text">
5380  <p>version of the LSCP specification the sampler  <p>version of the LSCP specification the sampler
5381                                              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)
5382    </p>
5383    </blockquote>
5384                                        
5385    
5386    </blockquote>
5387                                
5388    
5389    </blockquote><p>
5390                        
5391    </p>
5392    <p>The mentioned fields above don't have to be in particular order.
5393                        Other fields might be added in future.
5394    </p>
5395    <a name="MIDI Instrument Mapping"></a><br /><hr />
5396    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5397    <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;
5398    MIDI Instrument Mapping</h3>
5399    
5400    <p>The MIDI protocol provides a way to switch between instruments
5401                    by sending so called MIDI bank select and MIDI program change
5402                    messages which are essentially just numbers. The following commands
5403                    allow to actually map arbitrary MIDI bank select / program change
5404                    numbers with real instruments.
5405    </p>
5406    <p>The sampler allows to manage an arbitrary amount of MIDI
5407                    instrument maps which define which instrument to load on
5408                    which MIDI program change message.
5409    </p>
5410    <p>By default, that is when the sampler is launched, there is no
5411                    map, thus the sampler will simply ignore all program change
5412                    messages. The front-end has to explicitly create at least one
5413                    map, add entries to the map and tell the respective sampler
5414                    channel(s) which MIDI instrument map to use, so the sampler
5415                    knows how to react on a given program change message on the
5416                    respective sampler channel, that is by switching to the
5417                    respectively defined engine type and loading the respective
5418                    instrument. See command
5419                    <a class='info' href='#SET CHANNEL MIDI_INSTRUMENT_MAP'>"SET CHANNEL MIDI_INSTRUMENT_MAP"<span> (</span><span class='info'>Assigning a MIDI instrument map to a sampler channel</span><span>)</span></a>
5420                    for how to assign a MIDI instrument map to a sampler channel.
5421    </p>
5422    <p>Also note per MIDI specification a bank select message does not
5423                    cause to switch to another instrument. Instead when receiving a
5424                    bank select message the bank value will be stored and a subsequent
5425                    program change message (which may occur at any time) will finally
5426                    cause the sampler to switch to the respective instrument as
5427                    reflected by the current MIDI instrument map.
5428    </p>
5429    <a name="ADD MIDI_INSTRUMENT MAP"></a><br /><hr />
5430    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5431    <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;
5432    Create a new MIDI instrument map</h3>
5433    
5434    <p>The front-end can add a new MIDI instrument map by sending
5435                        the following command:
5436    </p>
5437    <p>
5438                            </p>
5439    <blockquote class="text">
5440    <p>ADD MIDI_INSTRUMENT_MAP [&lt;name&gt;]
5441    </p>
5442    </blockquote><p>
5443                        
5444    </p>
5445    <p>Where &lt;name&gt; is an optional argument allowing to
5446                        assign a custom name to the new map. MIDI instrument Map
5447                        names do not have to be unique.
5448    </p>
5449    <p>Possible Answers:
5450    </p>
5451    <p>
5452                            </p>
5453    <blockquote class="text">
5454    <p>"OK[&lt;map&gt;]" -
5455                                    </p>
5456    <blockquote class="text">
5457    <p>in case a new MIDI instrument map could
5458                                        be added, where &lt;map&gt; reflects the
5459                                        unique ID of the newly created MIDI
5460                                        instrument map
5461    </p>
5462    </blockquote>
5463                                
5464    
5465    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5466                                    </p>
5467    <blockquote class="text">
5468    <p>when a new map could not be created, which
5469                                        might never occur in practice
5470    </p>
5471    </blockquote>
5472                                
5473    
5474    </blockquote><p>
5475                        
5476    </p>
5477    <p>Examples:
5478    </p>
5479    <p>
5480                            </p>
5481    <blockquote class="text">
5482    <p>C: "ADD MIDI_INSTRUMENT_MAP 'Standard Map'"
5483    </p>
5484    <p>S: "OK[0]"
5485    </p>
5486    </blockquote><p>
5487                        
5488    </p>
5489    <p>
5490                            </p>
5491    <blockquote class="text">
5492    <p>C: "ADD MIDI_INSTRUMENT_MAP 'Standard Drumkit'"
5493    </p>
5494    <p>S: "OK[1]"
5495    </p>
5496    </blockquote><p>
5497                        
5498    </p>
5499    <p>
5500                            </p>
5501    <blockquote class="text">
5502    <p>C: "ADD MIDI_INSTRUMENT_MAP"
5503    </p>
5504    <p>S: "OK[5]"
5505    </p>
5506    </blockquote><p>
5507                        
5508    </p>
5509    <a name="REMOVE MIDI_INSTRUMENT_MAP"></a><br /><hr />
5510    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5511    <a name="rfc.section.6.7.2"></a><h3>6.7.2.&nbsp;
5512    Delete one particular or all MIDI instrument maps</h3>
5513    
5514    <p>The front-end can delete a particular MIDI instrument map
5515                        by sending the following command:
5516    </p>
5517    <p>
5518                            </p>
5519    <blockquote class="text">
5520    <p>REMOVE MIDI_INSTRUMENT_MAP &lt;map&gt;
5521    </p>
5522    </blockquote><p>
5523                        
5524    </p>
5525    <p>Where &lt;map&gt; reflects the unique ID of the map to delete
5526                        as returned by the <a class='info' href='#LIST MIDI_INSTRUMENT_MAPS'>"LIST MIDI_INSTRUMENT_MAPS"<span> (</span><span class='info'>Getting all created MIDI instrument maps</span><span>)</span></a>
5527                        command.
5528    </p>
5529    <p>The front-end can delete all MIDI instrument maps by
5530                        sending the following command:
5531    </p>
5532    <p>
5533                            </p>
5534    <blockquote class="text">
5535    <p>REMOVE MIDI_INSTRUMENT_MAP ALL
5536    </p>
5537    </blockquote><p>
5538                        
5539    </p>
5540    <p>Possible Answers:
5541    </p>
5542    <p>
5543                            </p>
5544    <blockquote class="text">
5545    <p>"OK" -
5546                                    </p>
5547    <blockquote class="text">
5548    <p>in case the map(s) could be deleted
5549    </p>
5550    </blockquote>
5551                                
5552    
5553    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5554                                    </p>
5555    <blockquote class="text">
5556    <p>when the given map does not exist
5557    </p>
5558    </blockquote>
5559                                
5560    
5561    </blockquote><p>
5562                        
5563    </p>
5564    <p>Examples:
5565    </p>
5566    <p>
5567                            </p>
5568    <blockquote class="text">
5569    <p>C: "REMOVE MIDI_INSTRUMENT_MAP 0"
5570    </p>
5571    <p>S: "OK"
5572    </p>
5573    </blockquote><p>
5574                        
5575    </p>
5576    <p>
5577                            </p>
5578    <blockquote class="text">
5579    <p>C: "REMOVE MIDI_INSTRUMENT_MAP ALL"
5580    </p>
5581    <p>S: "OK"
5582    </p>
5583    </blockquote><p>
5584                        
5585    </p>
5586    <a name="GET MIDI_INSTRUMENT_MAPS"></a><br /><hr />
5587    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5588    <a name="rfc.section.6.7.3"></a><h3>6.7.3.&nbsp;
5589    Get amount of existing MIDI instrument maps</h3>
5590    
5591    <p>The front-end can retrieve the current amount of MIDI
5592                        instrument maps by sending the following command:
5593    </p>
5594    <p>
5595                            </p>
5596    <blockquote class="text">
5597    <p>GET MIDI_INSTRUMENT_MAPS
5598    </p>
5599    </blockquote><p>
5600                        
5601    </p>
5602    <p>Possible Answers:
5603    </p>
5604    <p>
5605                            </p>
5606    <blockquote class="text">
5607    <p>The sampler will answer by returning the current
5608                                number of MIDI instrument maps.
5609    </p>
5610    </blockquote><p>
5611                        
5612    </p>
5613    <p>Example:
5614    </p>
5615    <p>
5616                            </p>
5617    <blockquote class="text">
5618    <p>C: "GET MIDI_INSTRUMENT_MAPS"
5619    </p>
5620    <p>S: "2"
5621    </p>
5622    </blockquote><p>
5623                        
5624    </p>
5625    <a name="LIST MIDI_INSTRUMENT_MAPS"></a><br /><hr />
5626    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5627    <a name="rfc.section.6.7.4"></a><h3>6.7.4.&nbsp;
5628    Getting all created MIDI instrument maps</h3>
5629    
5630    <p>The number of MIDI instrument maps can change on runtime. To get the
5631                        current list of MIDI instrument maps, the front-end can send the
5632                        following command:
5633    </p>
5634    <p>
5635                            </p>
5636    <blockquote class="text">
5637    <p>LIST MIDI_INSTRUMENT_MAPS
5638    </p>
5639    </blockquote><p>
5640                        
5641    </p>
5642    <p>Possible Answers:
5643    </p>
5644    <p>
5645                            </p>
5646    <blockquote class="text">
5647    <p>The sampler will answer by returning a comma separated list
5648                                with all MIDI instrument maps' numerical IDs.
5649    </p>
5650    </blockquote><p>
5651                        
5652    </p>
5653    <p>Example:
5654    </p>
5655    <p>
5656                            </p>
5657    <blockquote class="text">
5658    <p>C: "LIST MIDI_INSTRUMENT_MAPS"
5659    </p>
5660    <p>S: "0,1,5,12"
5661    </p>
5662    </blockquote><p>
5663                        
5664    </p>
5665    <a name="GET MIDI_INSTRUMENT_MAP INFO"></a><br /><hr />
5666    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5667    <a name="rfc.section.6.7.5"></a><h3>6.7.5.&nbsp;
5668    Getting MIDI instrument map information</h3>
5669    
5670    <p>The front-end can ask for the current settings of a MIDI
5671                        instrument map by sending the following command:
5672    </p>
5673    <p>
5674                            </p>
5675    <blockquote class="text">
5676    <p>GET MIDI_INSTRUMENT_MAP INFO &lt;map&gt;
5677  </p>  </p>
5678  </blockquote><p>  </blockquote><p>
5679                        
5680    </p>
5681    <p>Where &lt;map&gt; is the numerical ID of the map the
5682                        front-end is interested in as returned by the
5683                        <a class='info' href='#LIST MIDI_INSTRUMENT_MAPS'>"LIST MIDI_INSTRUMENT_MAPS"<span> (</span><span class='info'>Getting all created MIDI instrument maps</span><span>)</span></a>
5684                        command.
5685    </p>
5686    <p>Possible Answers:
5687    </p>
5688    <p>
5689                            </p>
5690    <blockquote class="text">
5691    <p>LinuxSampler will answer by sending a &lt;CRLF&gt; separated list.
5692                                Each answer line begins with the settings category name
5693                                followed by a colon and then a space character &lt;SP&gt; and finally
5694                                the info character string to that setting category. At the
5695                                moment the following categories are defined:
5696    </p>
5697    <p>
5698                                    </p>
5699    <blockquote class="text">
5700    <p>NAME -
5701                                            </p>
5702    <blockquote class="text">
5703    <p>custom name of the given map,
5704                                                which does not have to be unique
5705    </p>
5706    </blockquote>
5707                                        
5708    
5709    </blockquote>
5710                                
5711    
5712    </blockquote><p>
5713                        
5714    </p>
5715    <p>The mentioned fields above don't have to be in particular order.
5716    </p>
5717    <p>Example:
5718    </p>
5719    <p>
5720                            </p>
5721    <blockquote class="text">
5722    <p>C: "GET MIDI_INSTRUMENT_MAP INFO 0"
5723    </p>
5724    <p>S: "NAME: Standard Map"
5725    </p>
5726    <p>&nbsp;&nbsp;&nbsp;"."
5727  </p>  </p>
5728  </blockquote><p>  </blockquote><p>
5729                        
5730    </p>
5731    <a name="SET MIDI_INSTRUMENT_MAP NAME"></a><br /><hr />
5732    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5733    <a name="rfc.section.6.7.6"></a><h3>6.7.6.&nbsp;
5734    Renaming a MIDI instrument map</h3>
5735    
5736    <p>The front-end can alter the custom name of a MIDI
5737                        instrument map by sending the following command:
5738    </p>
5739    <p>
5740                            </p>
5741    <blockquote class="text">
5742    <p>SET MIDI_INSTRUMENT_MAP NAME &lt;map&gt; &lt;name&gt;
5743  </p>  </p>
5744  </blockquote><p>  </blockquote><p>
5745                        
5746    </p>
5747    <p>Where &lt;map&gt; is the numerical ID of the map and
5748                        &lt;name&gt; the new custom name of the map, which does not
5749                        have to be unique.
5750    </p>
5751    <p>Possible Answers:
5752    </p>
5753    <p>
5754                            </p>
5755    <blockquote class="text">
5756    <p>"OK" -
5757                                    </p>
5758    <blockquote class="text">
5759    <p>on success
5760    </p>
5761    </blockquote>
5762                                
5763    
5764    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5765                                    </p>
5766    <blockquote class="text">
5767    <p>in case the given map does not exist
5768    </p>
5769    </blockquote>
5770                                
5771    
5772    </blockquote><p>
5773                        
5774    </p>
5775    <p>Example:
5776    </p>
5777    <p>
5778                            </p>
5779    <blockquote class="text">
5780    <p>C: "SET MIDI_INSTRUMENT_MAP NAME 0 'Foo instruments'"
5781    </p>
5782    <p>S: "OK"
5783    </p>
5784    </blockquote><p>
5785                        
5786    </p>
5787    <a name="MAP MIDI_INSTRUMENT"></a><br /><hr />
5788    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5789    <a name="rfc.section.6.7.7"></a><h3>6.7.7.&nbsp;
5790    Create or replace a MIDI instrument map entry</h3>
5791    
5792    <p>The front-end can create a new or replace an existing entry
5793                        in a sampler's MIDI instrument map by sending the following
5794                        command:
5795    </p>
5796    <p>
5797                            </p>
5798    <blockquote class="text">
5799    <p>MAP MIDI_INSTRUMENT &lt;map&gt;
5800                                &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;
5801                                &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;
5802                                [&lt;instr_load_mode&gt;] [&lt;name&gt;]
5803    </p>
5804    </blockquote><p>
5805                        
5806    </p>
5807    <p>Where &lt;map&gt; is the numeric ID of the map to alter,
5808                        &lt;midi_bank&gt; is an integer value between
5809                        0..16383 reflecting the MIDI bank select index,
5810                        &lt;midi_prog&gt; an
5811                        integer value between 0..127 reflecting the MIDI program change
5812                        index, &lt;engine_name&gt; a sampler engine name as returned by
5813                        the <a class='info' href='#LIST AVAILABLE_ENGINES'>"LIST AVAILABLE_ENGINES"<span> (</span><span class='info'>Getting all available engines</span><span>)</span></a>
5814                        command (not encapsulated into apostrophes), &lt;filename&gt; the name
5815                        of the instrument's file to be deployed (encapsulated into apostrophes),
5816                        &lt;instrument_index&gt; the index (integer value) of the instrument
5817                        within the given file, &lt;volume_value&gt; reflects the master
5818                        volume of the instrument as optionally dotted number (where a
5819                        value < 1.0 means attenuation and a value > 1.0 means
5820                        amplification). This parameter easily allows to adjust the
5821                        volume of all intruments within a custom instrument map
5822                        without having to adjust their instrument files. The
5823                        OPTIONAL &lt;instr_load_mode&gt; argument defines the life
5824                        time of the instrument, that is when the instrument should
5825                        be loaded, when freed and has exactly the following
5826                        possibilities:
5827    </p>
5828    <p>
5829                            </p>
5830    <blockquote class="text">
5831    <p>"ON_DEMAND" -
5832                                    </p>
5833    <blockquote class="text">
5834    <p>The instrument will be loaded when needed,
5835                                        that is when demanded by at least one sampler
5836                                        channel. It will immediately be freed from memory
5837                                        when not needed by any sampler channel anymore.
5838    </p>
5839    </blockquote>
5840                                
5841    
5842    <p>"ON_DEMAND_HOLD" -
5843                                    </p>
5844    <blockquote class="text">
5845    <p>The instrument will be loaded when needed,
5846                                        that is when demanded by at least one sampler
5847                                        channel. It will be kept in memory even when
5848                                        not needed by any sampler channel anymore.
5849                                        Instruments with this mode are only freed
5850                                        when the sampler is reset or all mapping
5851                                        entries with this mode (and respective
5852                                        instrument) are explicitly changed to
5853                                        "ON_DEMAND" and no sampler channel is using
5854                                        the instrument anymore.
5855    </p>
5856    </blockquote>
5857                                
5858    
5859    <p>"PERSISTENT" -
5860                                    </p>
5861    <blockquote class="text">
5862    <p>The instrument will immediately be loaded
5863                                        into memory in the background when this mapping
5864                                        command is sent and the instrument is kept all
5865                                        the time. Instruments with this mode are
5866                                        only freed when the sampler is reset or all
5867                                        mapping entries with this mode (and
5868                                        respective instrument) are explicitly
5869                                        changed to "ON_DEMAND" and no sampler
5870                                        channel is using the instrument anymore.
5871    </p>
5872    </blockquote>
5873                                
5874    
5875    <p>not supplied -
5876                                    </p>
5877    <blockquote class="text">
5878    <p>In case there is no &lt;instr_load_mode&gt;
5879                                        argument given, it will be up to the
5880                                        InstrumentManager to decide which mode to use.
5881                                        Usually it will use "ON_DEMAND" if an entry
5882                                        for the given instrument does not exist in
5883                                        the InstrumentManager's list yet, otherwise
5884                                        if an entry already exists, it will simply
5885                                        stick with the mode currently reflected by
5886                                        the already existing entry, that is it will
5887                                        not change the mode.
5888    </p>
5889    </blockquote>
5890                                
5891    
5892    </blockquote><p>
5893                        
5894    </p>
5895    <p>
5896                        The &lt;instr_load_mode&gt; argument thus allows to define an
5897                        appropriate strategy (low memory consumption vs. fast
5898                        instrument switching) for each instrument individually. Note, the
5899                        following restrictions apply to this argument: "ON_DEMAND_HOLD" and
5900                        "PERSISTENT" have to be supported by the respective sampler engine
5901                        (which is technically the case when the engine provides an
5902                        InstrumentManager for its format). If this is not the case the
5903                        argument will automatically fall back to the default value
5904                        "ON_DEMAND". Also the load mode of one instrument may
5905                        automatically change the laod mode of other instrument(s), i.e.
5906                        because the instruments are part of the same file and the
5907                        engine does not allow a way to manage load modes for them
5908                        individually. Due to this, in case the frontend shows the
5909                        load modes of entries, the frontend should retrieve the actual
5910                        mode by i.e. sending
5911                        <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>
5912                        command(s). Finally the OPTIONAL &lt;name&gt; argument allows to
5913                        set a custom name (encapsulated into apostrophes) for the mapping
5914                        entry, useful for frontends for displaying an appropriate name for
5915                        mapped instruments (using
5916                        <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>).
5917                        
5918    </p>
5919    <p>
5920                        The "MAP MIDI_INSTRUMENT" command
5921                        will immediately return, thus it will not block when an
5922                        instrument is to be loaded due to a "PERSISTENT" type
5923                        entry as instruments are loaded in the background. As a
5924                        consequence this command may not necessarily return an error
5925                        i.e. when the given instrument file does not exist or may
5926                        turn out to be corrupt.
5927                        
5928    </p>
5929    <p>Possible Answers:
5930    </p>
5931    <p>
5932                            </p>
5933    <blockquote class="text">
5934    <p>"OK" -
5935                                    </p>
5936    <blockquote class="text">
5937    <p>usually
5938    </p>
5939    </blockquote>
5940                                
5941    
5942    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5943                                    </p>
5944    <blockquote class="text">
5945    <p>when the given map or engine does not exist or a value
5946                                        is out of range
5947    </p>
5948    </blockquote>
5949                                
5950    
5951    </blockquote><p>
5952                        
5953    </p>
5954    <p>Examples:
5955    </p>
5956    <p>
5957                            </p>
5958    <blockquote class="text">
5959    <p>C: "MAP MIDI_INSTRUMENT 0 3 0 gig '/usr/share/Steinway D.gig' 0 0.8 PERSISTENT"
5960  </p>  </p>
5961    <p>S: "OK"
5962    </p>
5963    </blockquote><p>
5964                        
5965    </p>
5966    <p>
5967                            </p>
5968    <blockquote class="text">
5969    <p>C: "MAP MIDI_INSTRUMENT 0 4 50 gig '/home/john/foostrings.gig' 7 1.0"
5970    </p>
5971    <p>S: "OK"
5972    </p>
5973    </blockquote><p>
5974                        
5975    </p>
5976    <p>
5977                            </p>
5978    <blockquote class="text">
5979    <p>C: "MAP MIDI_INSTRUMENT 0 0 0 gig '/usr/share/piano.gig' 0 1.0 'Normal Piano'"
5980    </p>
5981    <p>S: "OK"
5982    </p>
5983    <p>C: "MAP MIDI_INSTRUMENT 0 1 0 gig '/usr/share/piano.gig' 0 0.25 'Silent Piano'"
5984    </p>
5985    <p>S: "OK"
5986    </p>
5987    </blockquote><p>
5988                        
5989    </p>
5990    <p>
5991                            </p>
5992    <blockquote class="text">
5993    <p>C: "MAP MIDI_INSTRUMENT 1 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'"
5994    </p>
5995    <p>S: "OK"
5996    </p>
5997    </blockquote><p>
5998                        
5999    </p>
6000    <a name="GET MIDI_INSTRUMENTS"></a><br /><hr />
6001    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6002    <a name="rfc.section.6.7.8"></a><h3>6.7.8.&nbsp;
6003    Getting ammount of MIDI instrument map entries</h3>
6004    
6005    <p>The front-end can query the amount of currently existing
6006                        entries in a MIDI instrument map by sending the following
6007                        command:
6008    </p>
6009    <p>
6010                            </p>
6011    <blockquote class="text">
6012    <p>GET MIDI_INSTRUMENTS &lt;map&gt;
6013    </p>
6014    </blockquote><p>
6015                        
6016    </p>
6017    <p>The front-end can query the amount of currently existing
6018                        entries in all MIDI instrument maps by sending the following
6019                        command:
6020    </p>
6021    <p>
6022                            </p>
6023    <blockquote class="text">
6024    <p>GET MIDI_INSTRUMENTS ALL
6025    </p>
6026    </blockquote><p>
6027                        
6028    </p>
6029    <p>Possible Answers:
6030    </p>
6031    <p>
6032                            </p>
6033    <blockquote class="text">
6034    <p>The sampler will answer by sending the current number of
6035                                entries in the MIDI instrument map(s).
6036    </p>
6037    </blockquote><p>
6038                        
6039    </p>
6040    <p>Example:
6041    </p>
6042    <p>
6043                            </p>
6044    <blockquote class="text">
6045    <p>C: "GET MIDI_INSTRUMENTS 0"
6046    </p>
6047    <p>S: "234"
6048    </p>
6049    </blockquote><p>
6050                        
6051    </p>
6052    <p>
6053                            </p>
6054    <blockquote class="text">
6055    <p>C: "GET MIDI_INSTRUMENTS ALL"
6056    </p>
6057    <p>S: "954"
6058    </p>
6059    </blockquote><p>
6060                        
6061    </p>
6062    <a name="LIST MIDI_INSTRUMENTS"></a><br /><hr />
6063    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6064    <a name="rfc.section.6.7.9"></a><h3>6.7.9.&nbsp;
6065    Getting indeces of all entries of a MIDI instrument map</h3>
6066    
6067    <p>The front-end can query a list of all currently existing
6068                        entries in a certain MIDI instrument map by sending the following
6069                        command:
6070    </p>
6071    <p>
6072                            </p>
6073    <blockquote class="text">
6074    <p>LIST MIDI_INSTRUMENTS &lt;map&gt;
6075    </p>
6076    </blockquote><p>
6077                        
6078    </p>
6079    <p>Where &lt;map&gt; is the numeric ID of the MIDI instrument map.
6080    </p>
6081    <p>The front-end can query a list of all currently existing
6082                        entries of all MIDI instrument maps by sending the following
6083                        command:
6084    </p>
6085    <p>
6086                            </p>
6087    <blockquote class="text">
6088    <p>LIST MIDI_INSTRUMENTS ALL
6089    </p>
6090    </blockquote><p>
6091                        
6092    </p>
6093    <p>Possible Answers:
6094    </p>
6095    <p>
6096                            </p>
6097    <blockquote class="text">
6098    <p>The sampler will answer by sending a comma separated
6099                                list of map ID - MIDI bank - MIDI program triples, where
6100                                each triple is encapsulated into curly braces. The
6101                                list is returned in one single line. Each triple
6102                                just reflects the key of the respective map entry,
6103                                thus subsequent
6104                                <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>
6105                                command(s) are necessary to retrieve detailed informations
6106                                about each entry.
6107    </p>
6108    </blockquote><p>
6109                        
6110    </p>
6111    <p>Example:
6112    </p>
6113    <p>
6114                            </p>
6115    <blockquote class="text">
6116    <p>C: "LIST MIDI_INSTRUMENTS 0"
6117    </p>
6118    <p>S: "{0,0,0},{0,0,1},{0,0,3},{0,1,4},{1,127,127}"
6119    </p>
6120    </blockquote><p>
6121                        
6122    </p>
6123    <a name="UNMAP MIDI_INSTRUMENT"></a><br /><hr />
6124    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6125    <a name="rfc.section.6.7.10"></a><h3>6.7.10.&nbsp;
6126    Remove an entry from the MIDI instrument map</h3>
6127    
6128    <p>The front-end can delete an entry from a MIDI instrument
6129                        map by sending the following command:
6130    </p>
6131    <p>
6132                            </p>
6133    <blockquote class="text">
6134    <p>UNMAP MIDI_INSTRUMENT &lt;map&gt; &lt;midi_bank&gt; &lt;midi_prog&gt;
6135    </p>
6136    </blockquote><p>
6137                        
6138    </p>
6139    <p>
6140                        Where &lt;map&gt; is the numeric ID of the MIDI instrument map,
6141                        &lt;midi_bank&gt; is an integer value between 0..16383
6142                        reflecting the MIDI bank value and
6143                        &lt;midi_prog&gt; an integer value between
6144                        0..127 reflecting the MIDI program value of the map's entrie's key
6145                        index triple.
6146                        
6147    </p>
6148    <p>Possible Answers:
6149    </p>
6150    <p>
6151                            </p>
6152    <blockquote class="text">
6153    <p>"OK" -
6154                                    </p>
6155    <blockquote class="text">
6156    <p>usually
6157    </p>
6158    </blockquote>
6159                                
6160    
6161    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
6162                                    </p>
6163    <blockquote class="text">
6164    <p>when index out of bounds
6165    </p>
6166    </blockquote>
6167                                
6168    
6169    </blockquote><p>
6170                        
6171    </p>
6172    <p>Example:
6173    </p>
6174    <p>
6175                            </p>
6176    <blockquote class="text">
6177    <p>C: "UNMAP MIDI_INSTRUMENT 0 2 127"
6178    </p>
6179    <p>S: "OK"
6180    </p>
6181    </blockquote><p>
6182                        
6183    </p>
6184    <a name="GET MIDI_INSTRUMENT INFO"></a><br /><hr />
6185    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6186    <a name="rfc.section.6.7.11"></a><h3>6.7.11.&nbsp;
6187    Get current settings of MIDI instrument map entry</h3>
6188    
6189    <p>The front-end can retrieve the current settings of a certain
6190                        instrument map entry by sending the following command:
6191    </p>
6192    <p>
6193                            </p>
6194    <blockquote class="text">
6195    <p>GET MIDI_INSTRUMENT INFO &lt;map&gt; &lt;midi_bank&gt; &lt;midi_prog&gt;
6196    </p>
6197    </blockquote><p>
6198                        
6199    </p>
6200    <p>
6201                        Where &lt;map&gt; is the numeric ID of the MIDI instrument map,
6202                        &lt;midi_bank&gt; is an integer value between 0..16383
6203                        reflecting the MIDI bank value, &lt;midi_bank&gt;
6204                        and &lt;midi_prog&gt; an integer value between
6205                        0..127 reflecting the MIDI program value of the map's entrie's key
6206                        index triple.
6207                        
6208    </p>
6209    <p>Possible Answers:
6210    </p>
6211    <p>
6212                            </p>
6213    <blockquote class="text">
6214    <p>LinuxSampler will answer by sending a &lt;CRLF&gt;
6215                                separated list. Each answer line begins with the
6216                                information category name followed by a colon and then
6217                                a space character &lt;SP&gt; and finally the info
6218                                character string to that info category. At the moment
6219                                the following categories are defined:
6220    </p>
6221    <p>"NAME" -
6222                                    </p>
6223    <blockquote class="text">
6224    <p>Name for this MIDI instrument map entry (if defined).
6225                                        This name shall be used by frontends for displaying a
6226                                        name for this mapped instrument. It can be set and
6227                                        changed with the
6228                                        <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>
6229                                        command and does not have to be unique.
6230    </p>
6231    </blockquote>
6232                                
6233    
6234    <p>"ENGINE_NAME" -
6235                                    </p>
6236    <blockquote class="text">
6237    <p>Name of the engine to be deployed for this
6238                                        instrument.
6239    </p>
6240    </blockquote>
6241                                
6242    
6243    <p>"INSTRUMENT_FILE" -
6244                                    </p>
6245    <blockquote class="text">
6246    <p>File name of the instrument.
6247    </p>
6248    </blockquote>
6249                                
6250    
6251    <p>"INSTRUMENT_NR" -
6252                                    </p>
6253    <blockquote class="text">
6254    <p>Index of the instrument within the file.
6255    </p>
6256    </blockquote>
6257                                
6258    
6259    <p>"INSTRUMENT_NAME" -
6260                                    </p>
6261    <blockquote class="text">
6262    <p>Name of the loaded instrument as reflected by its file.
6263                                        In contrast to the "NAME" field, the "INSTRUMENT_NAME" field
6264                                        cannot be changed.
6265    </p>
6266    </blockquote>
6267                                
6268    
6269    <p>"LOAD_MODE" -
6270                                    </p>
6271    <blockquote class="text">
6272    <p>Life time of instrument
6273                                        (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).
6274    </p>
6275    </blockquote>
6276                                
6277    
6278    <p>"VOLUME" -
6279                                    </p>
6280    <blockquote class="text">
6281    <p>master volume of the instrument as optionally
6282                                        dotted number (where a value < 1.0 means attenuation
6283                                        and a value > 1.0 means amplification)
6284    </p>
6285    </blockquote>
6286                                
6287    
6288  <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.
6289                      Other fields might be added in future.  </p>
6290    </blockquote><p>
6291                        
6292    </p>
6293    <p>Example:
6294    </p>
6295    <p>
6296                            </p>
6297    <blockquote class="text">
6298    <p>C: "GET MIDI_INSTRUMENT INFO 1 45 120"
6299    </p>
6300    <p>S: "NAME: Drums for Foo Song"
6301    </p>
6302    <p>&nbsp;&nbsp;&nbsp;"ENGINE_NAME: GigEngine"
6303    </p>
6304    <p>&nbsp;&nbsp;&nbsp;"INSTRUMENT_FILE: /usr/share/joesdrumkit.gig"
6305    </p>
6306    <p>&nbsp;&nbsp;&nbsp;"INSTRUMENT_NR: 0"
6307    </p>
6308    <p>&nbsp;&nbsp;&nbsp;"INSTRUMENT_NAME: Joe's Drumkit"
6309    </p>
6310    <p>&nbsp;&nbsp;&nbsp;"LOAD_MODE: PERSISTENT"
6311    </p>
6312    <p>&nbsp;&nbsp;&nbsp;"VOLUME: 1.0"
6313    </p>
6314    <p>&nbsp;&nbsp;&nbsp;"."
6315    </p>
6316    </blockquote><p>
6317                        
6318    </p>
6319    <a name="CLEAR MIDI_INSTRUMENTS"></a><br /><hr />
6320    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6321    <a name="rfc.section.6.7.12"></a><h3>6.7.12.&nbsp;
6322    Clear MIDI instrument map</h3>
6323    
6324    <p>The front-end can clear a whole MIDI instrument map, that
6325                        is delete all its entries by sending the following command:
6326    </p>
6327    <p>
6328                            </p>
6329    <blockquote class="text">
6330    <p>CLEAR MIDI_INSTRUMENTS &lt;map&gt;
6331    </p>
6332    </blockquote><p>
6333                        
6334    </p>
6335    <p>Where &lt;map&gt; is the numeric ID of the map to clear.
6336    </p>
6337    <p>The front-end can clear all MIDI instrument maps, that
6338                        is delete all entries of all maps by sending the following
6339                        command:
6340    </p>
6341    <p>
6342                            </p>
6343    <blockquote class="text">
6344    <p>CLEAR MIDI_INSTRUMENTS ALL
6345    </p>
6346    </blockquote><p>
6347                        
6348    </p>
6349    <p>The command "CLEAR MIDI_INSTRUMENTS ALL" does not delete the
6350                        maps, only their entries, thus the map's settings like
6351                        custom name will be preservevd.
6352    </p>
6353    <p>Possible Answers:
6354    </p>
6355    <p>
6356                            </p>
6357    <blockquote class="text">
6358    <p>"OK" -
6359                                    </p>
6360    <blockquote class="text">
6361    <p>always
6362    </p>
6363    </blockquote>
6364                                
6365    
6366    </blockquote><p>
6367                        
6368    </p>
6369    <p>Examples:
6370    </p>
6371    <p>
6372                           </p>
6373    <blockquote class="text">
6374    <p>C: "CLEAR MIDI_INSTRUMENTS 0"
6375    </p>
6376    <p>S: "OK"
6377    </p>
6378    </blockquote><p>
6379                        
6380    </p>
6381    <p>
6382                           </p>
6383    <blockquote class="text">
6384    <p>C: "CLEAR MIDI_INSTRUMENTS ALL"
6385    </p>
6386    <p>S: "OK"
6387    </p>
6388    </blockquote><p>
6389                        
6390  </p>  </p>
6391  <a name="command_syntax"></a><br /><hr />  <a name="command_syntax"></a><br /><hr />
6392  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6393  <a name="rfc.section.7"></a><h3>7.&nbsp;Command Syntax</h3>  <a name="rfc.section.7"></a><h3>7.&nbsp;
6394    Command Syntax</h3>
6395    
6396  <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>
6397              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>)
6398              where applicable.              where applicable.
6399                
6400  </p>  </p>
6401  <p>input =  <p>input =
6402          </p>          </p>
6403  <blockquote class="text">  <blockquote class="text">
6404  <p>line LF  <p>line LF
6405                    
6406  </p>  </p>
6407  <p>/ line CR LF  <p>/ line CR LF
6408                    
6409  </p>  </p>
6410  </blockquote><p>  </blockquote><p>
6411    
# Line 4964  Intellectual Property and Copyright Stat Line 6414  Intellectual Property and Copyright Stat
6414          </p>          </p>
6415  <blockquote class="text">  <blockquote class="text">
6416  <p>/* epsilon (empty line ignored) */  <p>/* epsilon (empty line ignored) */
6417                    
6418  </p>  </p>
6419  <p>/ comment  <p>/ comment
6420                    
6421  </p>  </p>
6422  <p>/ command  <p>/ command
6423                    
6424  </p>  </p>
6425  <p>/ error  <p>/ error
6426                    
6427  </p>  </p>
6428  </blockquote><p>  </blockquote><p>
6429    
# Line 4982  Intellectual Property and Copyright Stat Line 6432  Intellectual Property and Copyright Stat
6432          </p>          </p>
6433  <blockquote class="text">  <blockquote class="text">
6434  <p>'#'  <p>'#'
6435                    
6436  </p>  </p>
6437  <p>/ comment '#'  <p>/ comment '#'
6438                    
6439  </p>  </p>
6440  <p>/ comment SP  <p>/ comment SP
6441                    
6442  </p>  </p>
6443  <p>/ comment number  <p>/ comment number
6444                    
6445  </p>  </p>
6446  <p>/ comment string  <p>/ comment string
6447                    
6448  </p>  </p>
6449  </blockquote><p>  </blockquote><p>
6450    
# Line 5002  Intellectual Property and Copyright Stat Line 6452  Intellectual Property and Copyright Stat
6452  <p>command =  <p>command =
6453          </p>          </p>
6454  <blockquote class="text">  <blockquote class="text">
6455  <p>ADD SP CHANNEL  <p>ADD SP add_instruction
6456                    
6457    </p>
6458    <p>/ MAP SP map_instruction
6459                    
6460    </p>
6461    <p>/ UNMAP SP unmap_instruction
6462                    
6463  </p>  </p>
6464  <p>/ GET SP get_instruction  <p>/ GET SP get_instruction
6465                    
6466  </p>  </p>
6467  <p>/ CREATE SP create_instruction  <p>/ CREATE SP create_instruction
6468                    
6469  </p>  </p>
6470  <p>/ DESTROY SP destroy_instruction  <p>/ DESTROY SP destroy_instruction
6471                    
6472  </p>  </p>
6473  <p>/ LIST SP list_instruction  <p>/ LIST SP list_instruction
6474                    
6475  </p>  </p>
6476  <p>/ LOAD SP load_instruction  <p>/ LOAD SP load_instruction
6477                    
6478  </p>  </p>
6479  <p>/ REMOVE SP CHANNEL SP sampler_channel  <p>/ REMOVE SP remove_instruction
6480                    
6481  </p>  </p>
6482  <p>/ SET SP set_instruction  <p>/ SET SP set_instruction
6483                    
6484  </p>  </p>
6485  <p>/ SUBSCRIBE SP subscribe_event  <p>/ SUBSCRIBE SP subscribe_event
6486                    
6487  </p>  </p>
6488  <p>/ UNSUBSCRIBE SP unsubscribe_event  <p>/ UNSUBSCRIBE SP unsubscribe_event
6489                    
6490  </p>  </p>
6491  <p>/ SELECT SP text  <p>/ SELECT SP text
6492                    
6493  </p>  </p>
6494  <p>/ RESET SP CHANNEL SP sampler_channel  <p>/ RESET SP reset_instruction
6495                    
6496    </p>
6497    <p>/ CLEAR SP clear_instruction
6498                    
6499  </p>  </p>
6500  <p>/ RESET  <p>/ RESET
6501                    
6502  </p>  </p>
6503  <p>/ QUIT  <p>/ QUIT
6504                    
6505    </p>
6506    </blockquote><p>
6507    
6508  </p>  </p>
6509    <p>add_instruction =
6510            </p>
6511    <blockquote class="text">
6512    <p>CHANNEL
6513                    
6514    </p>
6515    <p>/ MIDI_INSTRUMENT_MAP
6516                    
6517    </p>
6518    <p>/ MIDI_INSTRUMENT_MAP SP map_name
6519                    
6520    </p>
6521  </blockquote><p>  </blockquote><p>
6522    
6523  </p>  </p>
6524  <p>subscribe_event =  <p>subscribe_event =
6525          </p>          </p>
6526  <blockquote class="text">  <blockquote class="text">
6527  <p>CHANNEL_COUNT  <p>AUDIO_OUTPUT_DEVICE_COUNT
6528                    
6529    </p>
6530    <p>/ AUDIO_OUTPUT_DEVICE_INFO
6531                    
6532    </p>
6533    <p>/ MIDI_INPUT_DEVICE_COUNT
6534                    
6535    </p>
6536    <p>/ MIDI_INPUT_DEVICE_INFO
6537                    
6538    </p>
6539    <p>/ CHANNEL_COUNT
6540                    
6541  </p>  </p>
6542  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
6543                    
6544  </p>  </p>
6545  <p>/ STREAM_COUNT  <p>/ STREAM_COUNT
6546                    
6547  </p>  </p>
6548  <p>/ BUFFER_FILL  <p>/ BUFFER_FILL
6549                    
6550  </p>  </p>
6551  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
6552                    
6553    </p>
6554    <p>/ MIDI_INSTRUMENT_MAP_COUNT
6555                    
6556    </p>
6557    <p>/ MIDI_INSTRUMENT_MAP_INFO
6558                    
6559    </p>
6560    <p>/ MIDI_INSTRUMENT_COUNT
6561                    
6562    </p>
6563    <p>/ MIDI_INSTRUMENT_INFO
6564                    
6565  </p>  </p>
6566  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
6567                    
6568    </p>
6569    <p>/ TOTAL_VOICE_COUNT
6570                    
6571  </p>  </p>
6572  </blockquote><p>  </blockquote><p>
6573    
# Line 5074  Intellectual Property and Copyright Stat Line 6575  Intellectual Property and Copyright Stat
6575  <p>unsubscribe_event =  <p>unsubscribe_event =
6576          </p>          </p>
6577  <blockquote class="text">  <blockquote class="text">
6578  <p>CHANNEL_COUNT  <p>AUDIO_OUTPUT_DEVICE_COUNT
6579                    
6580    </p>
6581    <p>/ AUDIO_OUTPUT_DEVICE_INFO
6582                    
6583    </p>
6584    <p>/ MIDI_INPUT_DEVICE_COUNT
6585                    
6586    </p>
6587    <p>/ MIDI_INPUT_DEVICE_INFO
6588                    
6589    </p>
6590    <p>/ CHANNEL_COUNT
6591                    
6592  </p>  </p>
6593  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
6594                    
6595  </p>  </p>
6596  <p>/ STREAM_COUNT  <p>/ STREAM_COUNT
6597                    
6598  </p>  </p>
6599  <p>/ BUFFER_FILL  <p>/ BUFFER_FILL
6600                    
6601  </p>  </p>
6602  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
6603                    
6604    </p>
6605    <p>/ MIDI_INSTRUMENT_MAP_COUNT
6606                    
6607    </p>
6608    <p>/ MIDI_INSTRUMENT_MAP_INFO
6609                    
6610    </p>
6611    <p>/ MIDI_INSTRUMENT_COUNT
6612                    
6613    </p>
6614    <p>/ MIDI_INSTRUMENT_INFO
6615                    
6616  </p>  </p>
6617  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
6618                    
6619    </p>
6620    <p>/ TOTAL_VOICE_COUNT
6621                    
6622    </p>
6623    </blockquote><p>
6624    
6625    </p>
6626    <p>map_instruction =
6627            </p>
6628    <blockquote class="text">
6629    <p>MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value
6630                    
6631    </p>
6632    <p>/ MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode
6633                    
6634    </p>
6635    <p>/ MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP entry_name
6636                    
6637    </p>
6638    <p>/ MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode SP entry_name
6639                    
6640    </p>
6641    </blockquote><p>
6642    
6643  </p>  </p>
6644    <p>unmap_instruction =
6645            </p>
6646    <blockquote class="text">
6647    <p>MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog
6648                    
6649    </p>
6650    </blockquote><p>
6651    
6652    </p>
6653    <p>remove_instruction =
6654            </p>
6655    <blockquote class="text">
6656    <p>CHANNEL SP sampler_channel
6657                    
6658    </p>
6659    <p>/ MIDI_INSTRUMENT_MAP SP midi_map
6660                    
6661    </p>
6662    <p>/ MIDI_INSTRUMENT_MAP SP ALL
6663                    
6664    </p>
6665  </blockquote><p>  </blockquote><p>
6666    
6667  </p>  </p>
# Line 5099  Intellectual Property and Copyright Stat Line 6669  Intellectual Property and Copyright Stat
6669          </p>          </p>
6670  <blockquote class="text">  <blockquote class="text">
6671  <p>AVAILABLE_ENGINES  <p>AVAILABLE_ENGINES
6672                    
6673  </p>  </p>
6674  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS
6675                    
6676  </p>  </p>
6677  <p>/ MIDI_INPUT_DRIVER SP INFO SP string  <p>/ MIDI_INPUT_DRIVER SP INFO SP string
6678                    
6679  </p>  </p>
6680  <p>/ MIDI_INPUT_DRIVER_PARAMETER SP INFO SP string SP string  <p>/ MIDI_INPUT_DRIVER_PARAMETER SP INFO SP string SP string
6681                    
6682  </p>  </p>
6683  <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
6684                    
6685  </p>  </p>
6686  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS
6687                    
6688  </p>  </p>
6689  <p>/ AUDIO_OUTPUT_DRIVER SP INFO SP string  <p>/ AUDIO_OUTPUT_DRIVER SP INFO SP string
6690                    
6691  </p>  </p>
6692  <p>/ AUDIO_OUTPUT_DRIVER_PARAMETER SP INFO SP string SP string  <p>/ AUDIO_OUTPUT_DRIVER_PARAMETER SP INFO SP string SP string
6693                    
6694  </p>  </p>
6695  <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
6696                    
6697  </p>  </p>
6698  <p>/ AUDIO_OUTPUT_DEVICES  <p>/ AUDIO_OUTPUT_DEVICES
6699                    
6700  </p>  </p>
6701  <p>/ MIDI_INPUT_DEVICES  <p>/ MIDI_INPUT_DEVICES
6702                    
6703  </p>  </p>
6704  <p>/ AUDIO_OUTPUT_DEVICE SP INFO SP number  <p>/ AUDIO_OUTPUT_DEVICE SP INFO SP number
6705                    
6706  </p>  </p>
6707  <p>/ MIDI_INPUT_DEVICE SP INFO SP number  <p>/ MIDI_INPUT_DEVICE SP INFO SP number
6708                    
6709  </p>  </p>
6710  <p>/ MIDI_INPUT_PORT SP INFO SP number SP number  <p>/ MIDI_INPUT_PORT SP INFO SP number SP number
6711                    
6712  </p>  </p>
6713  <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
6714                    
6715  </p>  </p>
6716  <p>/ AUDIO_OUTPUT_CHANNEL SP INFO SP number SP number  <p>/ AUDIO_OUTPUT_CHANNEL SP INFO SP number SP number
6717                    
6718  </p>  </p>
6719  <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
6720                    
6721  </p>  </p>
6722  <p>/ CHANNELS  <p>/ CHANNELS
6723                    
6724  </p>  </p>
6725  <p>/ CHANNEL SP INFO SP sampler_channel  <p>/ CHANNEL SP INFO SP sampler_channel
6726                    
6727  </p>  </p>
6728  <p>/ CHANNEL SP BUFFER_FILL SP buffer_size_type SP sampler_channel  <p>/ CHANNEL SP BUFFER_FILL SP buffer_size_type SP sampler_channel
6729                    
6730  </p>  </p>
6731  <p>/ CHANNEL SP STREAM_COUNT SP sampler_channel  <p>/ CHANNEL SP STREAM_COUNT SP sampler_channel
6732                    
6733  </p>  </p>
6734  <p>/ CHANNEL SP VOICE_COUNT SP sampler_channel  <p>/ CHANNEL SP VOICE_COUNT SP sampler_channel
6735                    
6736  </p>  </p>
6737  <p>/ ENGINE SP INFO SP engine_name  <p>/ ENGINE SP INFO SP engine_name
6738                    
6739  </p>  </p>
6740  <p>/ SERVER SP INFO  <p>/ SERVER SP INFO
6741                    
6742    </p>
6743    <p>/ TOTAL_VOICE_COUNT
6744                    
6745    </p>
6746    <p>/ TOTAL_VOICE_COUNT_MAX
6747                    
6748    </p>
6749    <p>/ MIDI_INSTRUMENTS SP midi_map
6750                    
6751    </p>
6752    <p>/ MIDI_INSTRUMENTS SP ALL
6753                    
6754    </p>
6755    <p>/ MIDI_INSTRUMENT SP INFO SP midi_map SP midi_bank SP midi_prog
6756                    
6757    </p>
6758    <p>/ MIDI_INSTRUMENT_MAPS
6759                    
6760    </p>
6761    <p>/ MIDI_INSTRUMENT_MAP SP INFO SP midi_map
6762                    
6763  </p>  </p>
6764  </blockquote><p>  </blockquote><p>
6765    
# Line 5177  Intellectual Property and Copyright Stat Line 6768  Intellectual Property and Copyright Stat
6768          </p>          </p>
6769  <blockquote class="text">  <blockquote class="text">
6770  <p>AUDIO_OUTPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list  <p>AUDIO_OUTPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list
6771                    
6772  </p>  </p>
6773  <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
6774                    
6775  </p>  </p>
6776  <p>/ MIDI_INPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list  <p>/ MIDI_INPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list
6777                    
6778  </p>  </p>
6779  <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
6780                    
6781  </p>  </p>
6782  <p>/ CHANNEL SP set_chan_instruction  <p>/ CHANNEL SP set_chan_instruction
6783                    
6784    </p>
6785    <p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name
6786                    
6787  </p>  </p>
6788  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
6789                    
6790  </p>  </p>
6791  </blockquote><p>  </blockquote><p>
6792    
# Line 5201  Intellectual Property and Copyright Stat Line 6795  Intellectual Property and Copyright Stat
6795          </p>          </p>
6796  <blockquote class="text">  <blockquote class="text">
6797  <p>AUDIO_OUTPUT_DEVICE SP string SP key_val_list  <p>AUDIO_OUTPUT_DEVICE SP string SP key_val_list
6798                    
6799  </p>  </p>
6800  <p>/ AUDIO_OUTPUT_DEVICE SP string  <p>/ AUDIO_OUTPUT_DEVICE SP string
6801                    
6802  </p>  </p>
6803  <p>/ MIDI_INPUT_DEVICE SP string SP key_val_list  <p>/ MIDI_INPUT_DEVICE SP string SP key_val_list
6804                    
6805  </p>  </p>
6806  <p>/ MIDI_INPUT_DEVICE SP string  <p>/ MIDI_INPUT_DEVICE SP string
6807                    
6808    </p>
6809    </blockquote><p>
6810    
6811  </p>  </p>
6812    <p>reset_instruction =
6813            </p>
6814    <blockquote class="text">
6815    <p>CHANNEL SP sampler_channel
6816                    
6817    </p>
6818    </blockquote><p>
6819    
6820    </p>
6821    <p>clear_instruction =
6822            </p>
6823    <blockquote class="text">
6824    <p>MIDI_INSTRUMENTS SP midi_map
6825                    
6826    </p>
6827    <p>/ MIDI_INSTRUMENTS SP ALL
6828                    
6829    </p>
6830  </blockquote><p>  </blockquote><p>
6831    
6832  </p>  </p>
# Line 5219  Intellectual Property and Copyright Stat Line 6834  Intellectual Property and Copyright Stat
6834          </p>          </p>
6835  <blockquote class="text">  <blockquote class="text">
6836  <p>AUDIO_OUTPUT_DEVICE SP number  <p>AUDIO_OUTPUT_DEVICE SP number
6837                    
6838  </p>  </p>
6839  <p>/ MIDI_INPUT_DEVICE SP number  <p>/ MIDI_INPUT_DEVICE SP number
6840                    
6841  </p>  </p>
6842  </blockquote><p>  </blockquote><p>
6843    
# Line 5231  Intellectual Property and Copyright Stat Line 6846  Intellectual Property and Copyright Stat
6846          </p>          </p>
6847  <blockquote class="text">  <blockquote class="text">
6848  <p>INSTRUMENT SP load_instr_args  <p>INSTRUMENT SP load_instr_args
6849                    
6850  </p>  </p>
6851  <p>/ ENGINE SP load_engine_args  <p>/ ENGINE SP load_engine_args
6852                    
6853  </p>  </p>
6854  </blockquote><p>  </blockquote><p>
6855    
# Line 5243  Intellectual Property and Copyright Stat Line 6858  Intellectual Property and Copyright Stat
6858          </p>          </p>
6859  <blockquote class="text">  <blockquote class="text">
6860  <p>AUDIO_OUTPUT_DEVICE SP sampler_channel SP device_index  <p>AUDIO_OUTPUT_DEVICE SP sampler_channel SP device_index
6861                    
6862  </p>  </p>
6863  <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
6864                    
6865  </p>  </p>
6866  <p>/ AUDIO_OUTPUT_TYPE SP sampler_channel SP audio_output_type_name  <p>/ AUDIO_OUTPUT_TYPE SP sampler_channel SP audio_output_type_name
6867                    
6868  </p>  </p>
6869  <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
6870                    
6871  </p>  </p>
6872  <p>/ MIDI_INPUT_DEVICE SP sampler_channel SP device_index  <p>/ MIDI_INPUT_DEVICE SP sampler_channel SP device_index
6873                    
6874  </p>  </p>
6875  <p>/ MIDI_INPUT_PORT SP sampler_channel SP midi_input_port_index  <p>/ MIDI_INPUT_PORT SP sampler_channel SP midi_input_port_index
6876                    
6877  </p>  </p>
6878  <p>/ MIDI_INPUT_CHANNEL SP sampler_channel SP midi_input_channel_index  <p>/ MIDI_INPUT_CHANNEL SP sampler_channel SP midi_input_channel_index
6879                    
6880  </p>  </p>
6881  <p>/ MIDI_INPUT_TYPE SP sampler_channel SP midi_input_type_name  <p>/ MIDI_INPUT_TYPE SP sampler_channel SP midi_input_type_name
6882                    
6883  </p>  </p>
6884  <p>/ VOLUME SP sampler_channel SP volume_value  <p>/ VOLUME SP sampler_channel SP volume_value
6885                    
6886  </p>  </p>
6887  <p>/ MUTE SP sampler_channel SP boolean  <p>/ MUTE SP sampler_channel SP boolean
6888                    
6889  </p>  </p>
6890  <p>/ SOLO SP sampler_channel SP boolean  <p>/ SOLO SP sampler_channel SP boolean
6891                    
6892    </p>
6893    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP midi_map
6894                    
6895    </p>
6896    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP NONE
6897                    
6898    </p>
6899    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP DEFAULT
6900                    
6901  </p>  </p>
6902  </blockquote><p>  </blockquote><p>
6903    
# Line 5282  Intellectual Property and Copyright Stat Line 6906  Intellectual Property and Copyright Stat
6906          </p>          </p>
6907  <blockquote class="text">  <blockquote class="text">
6908  <p>string '=' param_val_list  <p>string '=' param_val_list
6909                    
6910  </p>  </p>
6911  <p>/ key_val_list SP string '=' param_val_list  <p>/ key_val_list SP string '=' param_val_list
6912                    
6913  </p>  </p>
6914  </blockquote><p>  </blockquote><p>
6915    
# Line 5294  Intellectual Property and Copyright Stat Line 6918  Intellectual Property and Copyright Stat
6918          </p>          </p>
6919  <blockquote class="text">  <blockquote class="text">
6920  <p>BYTES  <p>BYTES
6921                    
6922  </p>  </p>
6923  <p>/ PERCENTAGE  <p>/ PERCENTAGE
6924                    
6925  </p>  </p>
6926  </blockquote><p>  </blockquote><p>
6927    
# Line 5306  Intellectual Property and Copyright Stat Line 6930  Intellectual Property and Copyright Stat
6930          </p>          </p>
6931  <blockquote class="text">  <blockquote class="text">
6932  <p>AUDIO_OUTPUT_DEVICES  <p>AUDIO_OUTPUT_DEVICES
6933                    
6934  </p>  </p>
6935  <p>/ MIDI_INPUT_DEVICES  <p>/ MIDI_INPUT_DEVICES
6936                    
6937  </p>  </p>
6938  <p>/ CHANNELS  <p>/ CHANNELS
6939                    
6940  </p>  </p>
6941  <p>/ AVAILABLE_ENGINES  <p>/ AVAILABLE_ENGINES
6942                    
6943  </p>  </p>
6944  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS
6945                    
6946  </p>  </p>
6947  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS
6948                    
6949    </p>
6950    <p>/ MIDI_INSTRUMENTS SP midi_map
6951                    
6952    </p>
6953    <p>/ MIDI_INSTRUMENTS SP ALL
6954                    
6955    </p>
6956    <p>/ MIDI_INSTRUMENT_MAPS
6957                    
6958  </p>  </p>
6959  </blockquote><p>  </blockquote><p>
6960    
# Line 5330  Intellectual Property and Copyright Stat Line 6963  Intellectual Property and Copyright Stat
6963          </p>          </p>
6964  <blockquote class="text">  <blockquote class="text">
6965  <p>filename SP instrument_index SP sampler_channel  <p>filename SP instrument_index SP sampler_channel
6966                    
6967  </p>  </p>
6968  <p>/ NON_MODAL SP filename SP instrument_index SP sampler_channel  <p>/ NON_MODAL SP filename SP instrument_index SP sampler_channel
6969                    
6970  </p>  </p>
6971  </blockquote><p>  </blockquote><p>
6972    
# Line 5342  Intellectual Property and Copyright Stat Line 6975  Intellectual Property and Copyright Stat
6975          </p>          </p>
6976  <blockquote class="text">  <blockquote class="text">
6977  <p>engine_name SP sampler_channel  <p>engine_name SP sampler_channel
6978                    
6979    </p>
6980    </blockquote><p>
6981    
6982  </p>  </p>
6983    <p>instr_load_mode =
6984            </p>
6985    <blockquote class="text">
6986    <p>ON_DEMAND
6987                    
6988    </p>
6989    <p>/ ON_DEMAND_HOLD
6990                    
6991    </p>
6992    <p>/ PERSISTENT
6993                    
6994    </p>
6995  </blockquote><p>  </blockquote><p>
6996    
6997  </p>  </p>
# Line 5351  Intellectual Property and Copyright Stat Line 6999  Intellectual Property and Copyright Stat
6999          </p>          </p>
7000  <blockquote class="text">  <blockquote class="text">
7001  <p>number  <p>number
7002                    
7003  </p>  </p>
7004  </blockquote><p>  </blockquote><p>
7005    
# Line 5360  Intellectual Property and Copyright Stat Line 7008  Intellectual Property and Copyright Stat
7008          </p>          </p>
7009  <blockquote class="text">  <blockquote class="text">
7010  <p>number  <p>number
7011                    
7012  </p>  </p>
7013  </blockquote><p>  </blockquote><p>
7014    
# Line 5369  Intellectual Property and Copyright Stat Line 7017  Intellectual Property and Copyright Stat
7017          </p>          </p>
7018  <blockquote class="text">  <blockquote class="text">
7019  <p>string  <p>string
7020                    
7021  </p>  </p>
7022  </blockquote><p>  </blockquote><p>
7023    
# Line 5378  Intellectual Property and Copyright Stat Line 7026  Intellectual Property and Copyright Stat
7026          </p>          </p>
7027  <blockquote class="text">  <blockquote class="text">
7028  <p>number  <p>number
7029                    
7030  </p>  </p>
7031  </blockquote><p>  </blockquote><p>
7032    
# Line 5387  Intellectual Property and Copyright Stat Line 7035  Intellectual Property and Copyright Stat
7035          </p>          </p>
7036  <blockquote class="text">  <blockquote class="text">
7037  <p>number  <p>number
7038                    
7039  </p>  </p>
7040  <p>/ ALL  <p>/ ALL
7041                    
7042  </p>  </p>
7043  </blockquote><p>  </blockquote><p>
7044    
# Line 5399  Intellectual Property and Copyright Stat Line 7047  Intellectual Property and Copyright Stat
7047          </p>          </p>
7048  <blockquote class="text">  <blockquote class="text">
7049  <p>string  <p>string
7050                    
7051    </p>
7052    </blockquote><p>
7053    
7054    </p>
7055    <p>midi_map =
7056            </p>
7057    <blockquote class="text">
7058    <p>number
7059                    
7060    </p>
7061    </blockquote><p>
7062    
7063    </p>
7064    <p>midi_bank =
7065            </p>
7066    <blockquote class="text">
7067    <p>number
7068                    
7069    </p>
7070    </blockquote><p>
7071    
7072  </p>  </p>
7073    <p>midi_prog =
7074            </p>
7075    <blockquote class="text">
7076    <p>number
7077                    
7078    </p>
7079  </blockquote><p>  </blockquote><p>
7080    
7081  </p>  </p>
# Line 5408  Intellectual Property and Copyright Stat Line 7083  Intellectual Property and Copyright Stat
7083          </p>          </p>
7084  <blockquote class="text">  <blockquote class="text">
7085  <p>dotnum  <p>dotnum
7086                    
7087  </p>  </p>
7088  <p>/ number  <p>/ number
7089                    
7090  </p>  </p>
7091  </blockquote><p>  </blockquote><p>
7092    
# Line 5420  Intellectual Property and Copyright Stat Line 7095  Intellectual Property and Copyright Stat
7095          </p>          </p>
7096  <blockquote class="text">  <blockquote class="text">
7097  <p>number  <p>number
7098                    
7099  </p>  </p>
7100  </blockquote><p>  </blockquote><p>
7101    
# Line 5429  Intellectual Property and Copyright Stat Line 7104  Intellectual Property and Copyright Stat
7104          </p>          </p>
7105  <blockquote class="text">  <blockquote class="text">
7106  <p>number  <p>number
7107                    
7108  </p>  </p>
7109  </blockquote><p>  </blockquote><p>
7110    
# Line 5438  Intellectual Property and Copyright Stat Line 7113  Intellectual Property and Copyright Stat
7113          </p>          </p>
7114  <blockquote class="text">  <blockquote class="text">
7115  <p>string  <p>string
7116                    
7117  </p>  </p>
7118  </blockquote><p>  </blockquote><p>
7119    
# Line 5447  Intellectual Property and Copyright Stat Line 7122  Intellectual Property and Copyright Stat
7122          </p>          </p>
7123  <blockquote class="text">  <blockquote class="text">
7124  <p>stringval  <p>stringval
7125                    
7126    </p>
7127    </blockquote><p>
7128    
7129    </p>
7130    <p>map_name =
7131            </p>
7132    <blockquote class="text">
7133    <p>stringval
7134                    
7135    </p>
7136    </blockquote><p>
7137    
7138  </p>  </p>
7139    <p>entry_name =
7140            </p>
7141    <blockquote class="text">
7142    <p>stringval
7143                    
7144    </p>
7145  </blockquote><p>  </blockquote><p>
7146    
7147  </p>  </p>
# Line 5456  Intellectual Property and Copyright Stat Line 7149  Intellectual Property and Copyright Stat
7149          </p>          </p>
7150  <blockquote class="text">  <blockquote class="text">
7151  <p>param_val  <p>param_val
7152                    
7153  </p>  </p>
7154  <p>/ param_val_list','param_val  <p>/ param_val_list','param_val
7155                    
7156  </p>  </p>
7157  </blockquote><p>  </blockquote><p>
7158    
# Line 5468  Intellectual Property and Copyright Stat Line 7161  Intellectual Property and Copyright Stat
7161          </p>          </p>
7162  <blockquote class="text">  <blockquote class="text">
7163  <p>string  <p>string
7164                    
7165    </p>
7166    <p>/ stringval
7167                    
7168  </p>  </p>
7169  <p>/ '\'' string '\''  <p>/ number
7170                    
7171    </p>
7172    <p>/ dotnum
7173                    
7174    </p>
7175    </blockquote><p>
7176    
7177  </p>  </p>
7178  <p>/ '\"' string '\"'  <a name="events"></a><br /><hr />
7179    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7180    <a name="rfc.section.8"></a><h3>8.&nbsp;
7181    Events</h3>
7182    
7183    <p>This chapter will describe all currently defined events supported by LinuxSampler.
7184  </p>  </p>
7185  <p>/ number  <a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT"></a><br /><hr />
7186    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7187    <a name="rfc.section.8.1"></a><h3>8.1.&nbsp;
7188    Number of audio output devices changed</h3>
7189    
7190    <p>Client may want to be notified when the total number of audio output devices on the
7191                    back-end changes by issuing the following command:
7192  </p>  </p>
7193  <p>/ dotnum  <p>
7194                        </p>
7195    <blockquote class="text">
7196    <p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT
7197    </p>
7198    </blockquote><p>
7199                    
7200    </p>
7201    <p>Server will start sending the following notification messages:
7202    </p>
7203    <p>
7204                        </p>
7205    <blockquote class="text">
7206    <p>"NOTIFY:AUDIO_OUTPUT_DEVICE_COUNT:&lt;devices&gt;"
7207    </p>
7208    </blockquote><p>
7209                    
7210    </p>
7211    <p>where &lt;devices&gt; will be replaced by the new number
7212                    of audio output devices.
7213    </p>
7214    <a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO"></a><br /><hr />
7215    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7216    <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;
7217    Audio output device's settings changed</h3>
7218    
7219    <p>Client may want to be notified when changes were made to audio output devices on the
7220                    back-end by issuing the following command:
7221    </p>
7222    <p>
7223                        </p>
7224    <blockquote class="text">
7225    <p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO
7226    </p>
7227    </blockquote><p>
7228                    
7229    </p>
7230    <p>Server will start sending the following notification messages:
7231    </p>
7232    <p>
7233                        </p>
7234    <blockquote class="text">
7235    <p>"NOTIFY:AUDIO_OUTPUT_DEVICE_INFO:&lt;device-id&gt;"
7236  </p>  </p>
7237  </blockquote><p>  </blockquote><p>
7238                    
7239    </p>
7240    <p>where &lt;device-id&gt; will be replaced by the numerical ID of the audio output device,
7241                    which settings has been changed. The front-end will have to send
7242                    the respective command to actually get the audio output device info. Because these messages
7243                    will be triggered by LSCP commands issued by other clients rather than real
7244                    time events happening on the server, it is believed that an empty notification
7245                    message is sufficient here.
7246    </p>
7247    <a name="SUBSCRIBE MIDI_INPUT_DEVICE_COUNT"></a><br /><hr />
7248    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7249    <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;
7250    Number of MIDI input devices changed</h3>
7251    
7252    <p>Client may want to be notified when the total number of MIDI input devices on the
7253                    back-end changes by issuing the following command:
7254  </p>  </p>
7255  <a name="events"></a><br /><hr />  <p>
7256  <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>                      </p>
7257  <a name="rfc.section.8"></a><h3>8.&nbsp;Events</h3>  <blockquote class="text">
7258    <p>SUBSCRIBE MIDI_INPUT_DEVICE_COUNT
7259    </p>
7260    </blockquote><p>
7261                    
7262    </p>
7263    <p>Server will start sending the following notification messages:
7264    </p>
7265    <p>
7266                        </p>
7267    <blockquote class="text">
7268    <p>"NOTIFY:MIDI_INPUT_DEVICE_COUNT:&lt;devices&gt;"
7269    </p>
7270    </blockquote><p>
7271                    
7272    </p>
7273    <p>where &lt;devices&gt; will be replaced by the new number
7274                    of MIDI input devices.
7275    </p>
7276    <a name="SUBSCRIBE MIDI_INPUT_DEVICE_INFO"></a><br /><hr />
7277    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7278    <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;
7279    MIDI input device's settings changed</h3>
7280    
7281  <p>This chapter will describe all currently defined events supported by LinuxSampler.  <p>Client may want to be notified when changes were made to MIDI input devices on the
7282                    back-end by issuing the following command:
7283    </p>
7284    <p>
7285                        </p>
7286    <blockquote class="text">
7287    <p>SUBSCRIBE MIDI_INPUT_DEVICE_INFO
7288    </p>
7289    </blockquote><p>
7290                    
7291    </p>
7292    <p>Server will start sending the following notification messages:
7293    </p>
7294    <p>
7295                        </p>
7296    <blockquote class="text">
7297    <p>"NOTIFY:MIDI_INPUT_DEVICE_INFO:&lt;device-id&gt;"
7298    </p>
7299    </blockquote><p>
7300                    
7301    </p>
7302    <p>where &lt;device-id&gt; will be replaced by the numerical ID of the MIDI input device,
7303                    which settings has been changed. The front-end will have to send
7304                    the respective command to actually get the MIDI input device info. Because these messages
7305                    will be triggered by LSCP commands issued by other clients rather than real
7306                    time events happening on the server, it is believed that an empty notification
7307                    message is sufficient here.
7308  </p>  </p>
7309  <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_COUNT"></a><br /><hr />
7310    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7311    <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;
7312    Number of sampler channels changed</h3>
7313    
7314  <p>Client may want to be notified when the total number of channels on the  <p>Client may want to be notified when the total number of channels on the
7315                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 5502  Intellectual Property and Copyright Stat Line 7320  Intellectual Property and Copyright Stat
7320  <p>SUBSCRIBE CHANNEL_COUNT  <p>SUBSCRIBE CHANNEL_COUNT
7321  </p>  </p>
7322  </blockquote><p>  </blockquote><p>
7323                    
7324  </p>  </p>
7325  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
7326  </p>  </p>
# Line 5512  Intellectual Property and Copyright Stat Line 7330  Intellectual Property and Copyright Stat
7330  <p>"NOTIFY:CHANNEL_COUNT:&lt;channels&gt;"  <p>"NOTIFY:CHANNEL_COUNT:&lt;channels&gt;"
7331  </p>  </p>
7332  </blockquote><p>  </blockquote><p>
7333                    
7334  </p>  </p>
7335  <p>where &lt;channels&gt; will be replaced by the new number  <p>where &lt;channels&gt; will be replaced by the new number
7336                  of sampler channels.                  of sampler channels.
7337  </p>  </p>
7338  <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 />
7339    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7340    <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;
7341    Number of active voices changed</h3>
7342    
7343  <p>Client may want to be notified when the number of voices on the  <p>Client may want to be notified when the number of voices on the
7344                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 5528  Intellectual Property and Copyright Stat Line 7349  Intellectual Property and Copyright Stat
7349  <p>SUBSCRIBE VOICE_COUNT  <p>SUBSCRIBE VOICE_COUNT
7350  </p>  </p>
7351  </blockquote><p>  </blockquote><p>
7352                    
7353  </p>  </p>
7354  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
7355  </p>  </p>
# Line 5538  Intellectual Property and Copyright Stat Line 7359  Intellectual Property and Copyright Stat
7359  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;
7360  </p>  </p>
7361  </blockquote><p>  </blockquote><p>
7362                    
7363  </p>  </p>
7364  <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
7365                  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
7366                  active voices on that channel.                  active voices on that channel.
7367  </p>  </p>
7368  <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 />
7369    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7370    <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
7371    Number of active disk streams changed</h3>
7372    
7373  <p>Client may want to be notified when the number of streams on the back-end  <p>Client may want to be notified when the number of streams on the back-end
7374                  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 7379  Intellectual Property and Copyright Stat
7379  <p>SUBSCRIBE STREAM_COUNT  <p>SUBSCRIBE STREAM_COUNT
7380  </p>  </p>
7381  </blockquote><p>  </blockquote><p>
7382                    
7383  </p>  </p>
7384  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
7385  </p>  </p>
# Line 5565  Intellectual Property and Copyright Stat Line 7389  Intellectual Property and Copyright Stat
7389  <p>"NOTIFY:STREAM_COUNT:&lt;sampler-channel&gt; &lt;streams&gt;"  <p>"NOTIFY:STREAM_COUNT:&lt;sampler-channel&gt; &lt;streams&gt;"
7390  </p>  </p>
7391  </blockquote><p>  </blockquote><p>
7392                    
7393  </p>  </p>
7394  <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
7395                  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
7396                  active disk streams on that channel.                  active disk streams on that channel.
7397  </p>  </p>
7398  <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 />
7399    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7400    <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
7401    Disk stream buffer fill state changed</h3>
7402    
7403  <p>Client may want to be notified when the buffer fill state of a disk stream  <p>Client may want to be notified when the buffer fill state of a disk stream
7404                  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 7409  Intellectual Property and Copyright Stat
7409  <p>SUBSCRIBE BUFFER_FILL  <p>SUBSCRIBE BUFFER_FILL
7410  </p>  </p>
7411  </blockquote><p>  </blockquote><p>
7412                    
7413  </p>  </p>
7414  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
7415  </p>  </p>
# Line 5592  Intellectual Property and Copyright Stat Line 7419  Intellectual Property and Copyright Stat
7419  <p>"NOTIFY:BUFFER_FILL:&lt;sampler-channel&gt; &lt;fill-data&gt;"  <p>"NOTIFY:BUFFER_FILL:&lt;sampler-channel&gt; &lt;fill-data&gt;"
7420  </p>  </p>
7421  </blockquote><p>  </blockquote><p>
7422                    
7423  </p>  </p>
7424  <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
7425                  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
7426                  buffer fill data for this channel as described in <a class="info" href="#GET CHANNEL BUFFER_FILL">Section&nbsp;6.4.13<span> (</span><span class="info">Current fill state of disk stream buffers</span><span>)</span></a>                  buffer fill data for this channel as described in <a class='info' href='#GET CHANNEL BUFFER_FILL'>Section&nbsp;6.4.13<span> (</span><span class='info'>Current fill state of disk stream buffers</span><span>)</span></a>
7427                  as if the <a class="info" href="#GET CHANNEL BUFFER_FILL">"GET CHANNEL BUFFER_FILL PERCENTAGE"<span> (</span><span class="info">Current fill state of disk stream buffers</span><span>)</span></a> command was issued on this channel.                  as if the <a class='info' href='#GET CHANNEL BUFFER_FILL'>"GET CHANNEL BUFFER_FILL PERCENTAGE"<span> (</span><span class='info'>Current fill state of disk stream buffers</span><span>)</span></a> command was issued on this channel.
7428  </p>  </p>
7429  <a name="rfc.section.8.5"></a><h4><a name="SUBSCRIBE INFO">8.5</a>&nbsp;Channel information changed</h4>  <a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr />
7430    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7431    <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
7432    Channel information changed</h3>
7433    
7434  <p>Client may want to be notified when changes were made to sampler channels on the  <p>Client may want to be notified when changes were made to sampler channels on the
7435                  back-end by issuing the following command:                  back-end by issuing the following command:
# Line 5610  Intellectual Property and Copyright Stat Line 7440  Intellectual Property and Copyright Stat
7440  <p>SUBSCRIBE CHANNEL_INFO  <p>SUBSCRIBE CHANNEL_INFO
7441  </p>  </p>
7442  </blockquote><p>  </blockquote><p>
7443                    
7444  </p>  </p>
7445  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
7446  </p>  </p>
# Line 5620  Intellectual Property and Copyright Stat Line 7450  Intellectual Property and Copyright Stat
7450  <p>"NOTIFY:CHANNEL_INFO:&lt;sampler-channel&gt;"  <p>"NOTIFY:CHANNEL_INFO:&lt;sampler-channel&gt;"
7451  </p>  </p>
7452  </blockquote><p>  </blockquote><p>
7453                    
7454  </p>  </p>
7455  <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
7456                  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 7459  Intellectual Property and Copyright Stat
7459                  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
7460                  message is sufficient here.                  message is sufficient here.
7461  </p>  </p>
7462  <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 />
7463    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7464    <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
7465    Total number of active voices changed</h3>
7466    
7467    <p>Client may want to be notified when the total number of voices on the
7468                    back-end changes by issuing the following command:
7469    </p>
7470    <p>
7471                        </p>
7472    <blockquote class="text">
7473    <p>SUBSCRIBE TOTAL_VOICE_COUNT
7474    </p>
7475    </blockquote><p>
7476                    
7477    </p>
7478    <p>Server will start sending the following notification messages:
7479    </p>
7480    <p>
7481                        </p>
7482    <blockquote class="text">
7483    <p>"NOTIFY:TOTAL_VOICE_COUNT:&lt;voices&gt;
7484    </p>
7485    </blockquote><p>
7486                    
7487    </p>
7488    <p>where &lt;voices&gt; will be replaced by the new number of
7489                    all currently active voices.
7490    </p>
7491    <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />
7492    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7493    <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
7494    Number of MIDI instrument maps changed</h3>
7495    
7496    <p>Client may want to be notified when the number of MIDI instrument maps on the
7497                    back-end changes by issuing the following command:
7498    </p>
7499    <p>
7500                        </p>
7501    <blockquote class="text">
7502    <p>SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT
7503    </p>
7504    </blockquote><p>
7505                    
7506    </p>
7507    <p>Server will start sending the following notification messages:
7508    </p>
7509    <p>
7510                        </p>
7511    <blockquote class="text">
7512    <p>"NOTIFY:MIDI_INSTRUMENT_MAP_COUNT:&lt;maps&gt;"
7513    </p>
7514    </blockquote><p>
7515                    
7516    </p>
7517    <p>where &lt;maps&gt; will be replaced by the new number
7518                    of MIDI instrument maps.
7519    </p>
7520    <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />
7521    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7522    <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
7523    MIDI instrument map information changed</h3>
7524    
7525    <p>Client may want to be notified when changes were made to MIDI instrument maps on the
7526                    back-end by issuing the following command:
7527    </p>
7528    <p>
7529                        </p>
7530    <blockquote class="text">
7531    <p>SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO
7532    </p>
7533    </blockquote><p>
7534                    
7535    </p>
7536    <p>Server will start sending the following notification messages:
7537    </p>
7538    <p>
7539                        </p>
7540    <blockquote class="text">
7541    <p>"NOTIFY:MIDI_INSTRUMENT_MAP_INFO:&lt;map-id&gt;"
7542    </p>
7543    </blockquote><p>
7544                    
7545    </p>
7546    <p>where &lt;map-id&gt; will be replaced by the numerical ID of the MIDI instrument map,
7547                    for which information changes occurred. The front-end will have to send
7548                    the respective command to actually get the MIDI instrument map info. Because these messages
7549                    will be triggered by LSCP commands issued by other clients rather than real
7550                    time events happening on the server, it is believed that an empty notification
7551                    message is sufficient here.
7552    </p>
7553    <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />
7554    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7555    <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
7556    Number of MIDI instruments changed</h3>
7557    
7558    <p>Client may want to be notified when the number of MIDI instrument maps on the
7559                    back-end changes by issuing the following command:
7560    </p>
7561    <p>
7562                        </p>
7563    <blockquote class="text">
7564    <p>SUBSCRIBE MIDI_INSTRUMENT_COUNT
7565    </p>
7566    </blockquote><p>
7567                    
7568    </p>
7569    <p>Server will start sending the following notification messages:
7570    </p>
7571    <p>
7572                        </p>
7573    <blockquote class="text">
7574    <p>"NOTIFY:MIDI_INSTRUMENT_COUNT:&lt;map-id&gt; &lt;instruments&gt;"
7575    </p>
7576    </blockquote><p>
7577                    
7578    </p>
7579    <p>where &lt;map-id&gt; is the numerical ID of the MIDI instrument map, in which
7580                    the nuber of instruments has changed and &lt;instruments&gt; will be replaced by
7581                    the new number of MIDI instruments in the specified map.
7582    </p>
7583    <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />
7584    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7585    <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
7586    MIDI instrument information changed</h3>
7587    
7588    <p>Client may want to be notified when changes were made to MIDI instruments on the
7589                    back-end by issuing the following command:
7590    </p>
7591    <p>
7592                        </p>
7593    <blockquote class="text">
7594    <p>SUBSCRIBE MIDI_INSTRUMENT_INFO
7595    </p>
7596    </blockquote><p>
7597                    
7598    </p>
7599    <p>Server will start sending the following notification messages:
7600    </p>
7601    <p>
7602                        </p>
7603    <blockquote class="text">
7604    <p>"NOTIFY:MIDI_INSTRUMENT_INFO:&lt;map-id&gt; &lt;bank&gt; &lt;program&gt;"
7605    </p>
7606    </blockquote><p>
7607                    
7608    </p>
7609    <p>where &lt;map-id&gt; will be replaced by the numerical ID of the MIDI instrument map,
7610                    in which a MIDI instrument is changed. &lt;bank&gt; and &lt;program&gt; specifies
7611                    the location of the changed MIDI instrument in the map. The front-end will have to send
7612                    the respective command to actually get the MIDI instrument info. Because these messages
7613                    will be triggered by LSCP commands issued by other clients rather than real
7614                    time events happening on the server, it is believed that an empty notification
7615                    message is sufficient here.
7616    </p>
7617    <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
7618    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7619    <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
7620    Miscellaneous and debugging events</h3>
7621    
7622  <p>Client may want to be notified of miscellaneous and debugging events occurring at  <p>Client may want to be notified of miscellaneous and debugging events occurring at
7623                  the server by issuing the following command:                  the server by issuing the following command:
# Line 5640  Intellectual Property and Copyright Stat Line 7628  Intellectual Property and Copyright Stat
7628  <p>SUBSCRIBE MISCELLANEOUS  <p>SUBSCRIBE MISCELLANEOUS
7629  </p>  </p>
7630  </blockquote><p>  </blockquote><p>
7631                    
7632  </p>  </p>
7633  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
7634  </p>  </p>
# Line 5650  Intellectual Property and Copyright Stat Line 7638  Intellectual Property and Copyright Stat
7638  <p>"NOTIFY:MISCELLANEOUS:&lt;string&gt;"  <p>"NOTIFY:MISCELLANEOUS:&lt;string&gt;"
7639  </p>  </p>
7640  </blockquote><p>  </blockquote><p>
7641                    
7642  </p>  </p>
7643  <p>where &lt;string&gt; will be replaced by whatever data server  <p>where &lt;string&gt; will be replaced by whatever data server
7644                  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
7645                  user AS IS to facilitate debugging.                  user AS IS to facilitate debugging.
7646  </p>  </p>
7647  <a name="anchor14"></a><br /><hr />  <a name="anchor14"></a><br /><hr />
7648  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7649  <a name="rfc.section.9"></a><h3>9.&nbsp;Security Considerations</h3>  <a name="rfc.section.9"></a><h3>9.&nbsp;
7650    Security Considerations</h3>
7651    
7652  <p>As there is so far no method of authentication and authorization  <p>As there is so far no method of authentication and authorization
7653              defined and so not required for a client applications to succeed to              defined and so not required for a client applications to succeed to
# Line 5666  Intellectual Property and Copyright Stat Line 7655  Intellectual Property and Copyright Stat
7655              system the LinuxSampler instance is running on.              system the LinuxSampler instance is running on.
7656  </p>  </p>
7657  <a name="anchor15"></a><br /><hr />  <a name="anchor15"></a><br /><hr />
7658  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7659  <a name="rfc.section.10"></a><h3>10.&nbsp;Acknowledgments</h3>  <a name="rfc.section.10"></a><h3>10.&nbsp;
7660    Acknowledgments</h3>
7661    
7662  <p>This document has benefited greatly from the comments of the  <p>This document has benefited greatly from the comments of the
7663              following people, discussed on the LinuxSampler developer's mailing              following people, discussed on the LinuxSampler developer's mailing
# Line 5685  Intellectual Property and Copyright Stat Line 7675  Intellectual Property and Copyright Stat
7675  <p>Grigor Iliev  <p>Grigor Iliev
7676  </p>  </p>
7677  </blockquote><p>  </blockquote><p>
7678                
7679  </p>  </p>
7680  <a name="rfc.references1"></a><br /><hr />  <a name="rfc.references1"></a><br /><hr />
7681  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7682  <h3>11.&nbsp;References</h3>  <h3>11.&nbsp;References</h3>
7683  <table width="99%" border="0">  <table width="99%" border="0">
7684  <tr><td class="author-text" valign="top"><a name="RFC2119">[RFC2119]</a></td>  <tr><td class="author-text" valign="top"><a name="RFC2119">[RFC2119]</a></td>
# Line 5700  Intellectual Property and Copyright Stat Line 7690  Intellectual Property and Copyright Stat
7690  </table>  </table>
7691    
7692  <a name="rfc.authors"></a><br /><hr />  <a name="rfc.authors"></a><br /><hr />
7693  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7694  <h3>Author's Address</h3>  <h3>Author's Address</h3>
7695  <table width="99%" border="0" cellpadding="0" cellspacing="0">  <table width="99%" border="0" cellpadding="0" cellspacing="0">
7696  <tr><td class="author-text">&nbsp;</td>  <tr><td class="author-text">&nbsp;</td>
# Line 5718  Schoenebeck</td></tr> Line 7708  Schoenebeck</td></tr>
7708  <td class="author-text"><a href="mailto:schoenebeck at software minus engineering dot org">schoenebeck at software minus engineering dot org</a></td></tr>  <td class="author-text"><a href="mailto:schoenebeck at software minus engineering dot org">schoenebeck at software minus engineering dot org</a></td></tr>
7709  </table>  </table>
7710  <a name="rfc.copyright"></a><br /><hr />  <a name="rfc.copyright"></a><br /><hr />
7711  <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="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7712  <h3>Intellectual Property Statement</h3>  <h3>Full Copyright Statement</h3>
7713  <p class='copyright'>  <p class='copyright'>
7714  The IETF takes no position regarding the validity or scope of  Copyright &copy; The Internet Society (2006).</p>
 any intellectual property or other rights that might be claimed  
 to  pertain to the implementation or use of the technology  
 described in this document or the extent to which any license  
 under such rights might or might not be available; neither does  
 it represent that it has made any effort to identify any such  
 rights. Information on the IETF's procedures with respect to  
 rights in standards-track and standards-related documentation  
 can be found in BCP&nbsp;11. Copies of claims of rights made  
 available for publication and any assurances of licenses to  
 be made available, or the result of an attempt made  
 to obtain a general license or permission for the use of such  
 proprietary rights by implementors or users of this  
 specification can be obtained from the IETF Secretariat.</p>  
7715  <p class='copyright'>  <p class='copyright'>
7716  The IETF invites any interested party to bring to its  This document is subject to the rights,
7717  attention any copyrights, patents or patent applications, or  licenses and restrictions contained in BCP&nbsp;78,
7718  other proprietary rights which may cover technology that may be  and except as set forth therein,
7719  required to practice this standard. Please address the  the authors retain all their rights.</p>
 information to the IETF Executive Director.</p>  
 <h3>Full Copyright Statement</h3>  
7720  <p class='copyright'>  <p class='copyright'>
7721  Copyright &copy; The Internet Society (2005). All Rights Reserved.</p>  This document and the information contained herein are provided
7722    on an &ldquo;AS IS&rdquo; basis and THE CONTRIBUTOR,
7723    THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY),
7724    THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM
7725    ALL WARRANTIES,
7726    EXPRESS OR IMPLIED,
7727    INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
7728    INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
7729    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>
7730    <h3>Intellectual Property</h3>
7731  <p class='copyright'>  <p class='copyright'>
7732  This document and translations of it may be copied and furnished to  The IETF takes no position regarding the validity or scope of any
7733  others, and derivative works that comment on or otherwise explain it  Intellectual Property Rights or other rights that might be claimed
7734  or assist in its implementation may be prepared, copied, published and  to pertain to the implementation or use of the technology
7735  distributed, in whole or in part, without restriction of any kind,  described in this document or the extent to which any license
7736  provided that the above copyright notice and this paragraph are  under such rights might or might not be available; nor does it
7737  included on all such copies and derivative works. However, this  represent that it has made any independent effort to identify any
7738  document itself may not be modified in any way, such as by removing  such rights.
7739  the copyright notice or references to the Internet Society or other  Information on the procedures with respect to
7740  Internet organizations, except as needed for the purpose of  rights in RFC documents can be found in BCP&nbsp;78 and BCP&nbsp;79.</p>
 developing Internet standards in which case the procedures for  
 copyrights defined in the Internet Standards process must be  
 followed, or as required to translate it into languages other than  
 English.</p>  
7741  <p class='copyright'>  <p class='copyright'>
7742  The limited permissions granted above are perpetual and will not be  Copies of IPR disclosures made to the IETF Secretariat and any
7743  revoked by the Internet Society or its successors or assignees.</p>  assurances of licenses to be made available,
7744    or the result of an attempt made to obtain a general license or
7745    permission for the use of such proprietary rights by implementers or
7746    users of this specification can be obtained from the IETF on-line IPR
7747    repository at <a href='http://www.ietf.org/ipr'>http://www.ietf.org/ipr</a>.</p>
7748  <p class='copyright'>  <p class='copyright'>
7749  This document and the information contained herein is provided on an  The IETF invites any interested party to bring to its attention
7750  &ldquo;AS IS&rdquo; basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING  any copyrights,
7751  TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING  patents or patent applications,
7752  BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION  or other
7753  HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF  proprietary rights that may cover technology that may be required
7754  MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>  to implement this standard.
7755    Please address the information to the IETF at <a href='mailto:ietf-ipr@ietf.org'>ietf-ipr@ietf.org</a>.</p>
7756  <h3>Acknowledgment</h3>  <h3>Acknowledgment</h3>
7757  <p class='copyright'>  <p class='copyright'>
7758  Funding for the RFC Editor function is currently provided by the  Funding for the RFC Editor function is provided by
7759  Internet Society.</p>  the IETF Administrative Support Activity (IASA).</p>
7760  </body></html>  </body></html>
Legend:
Removed from v.708  
changed lines
  Added in v.992
  ViewVC Help
Powered by ViewVC