/[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 940 by schoenebeck, Sat Nov 25 17:18:12 2006 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.30 (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      table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; }          a.info:hover {
62      td.toc { font-size: small; font-weight: bold; vertical-align: text-top; }                  z-index: 25;
63                    color: #FFF; background-color: #900;
64      span.emph { font-style: italic; }          }
65      span.strong { font-weight: bold; }          a.info span { display: none; }
66      span.verb, span.vbare { font-family: "Courier New", Courier, monospace ; }          a.info:hover span.info {
67                    /* The span will display just on :hover state. */
68      span.vemph { font-style: italic; font-family: "Courier New", Courier, monospace ; }                  display: block;
69      span.vstrong { font-weight: bold; font-family: "Courier New", Courier, monospace ; }                  position: absolute;
70      span.vdeluxe { font-weight: bold; font-style: italic; font-family: "Courier New", Courier, monospace ; }                  font-size: smaller;
71                    top: 2em; left: -5em; width: 15em;
72      ol.text { margin-left: 2em; margin-right: 2em; }                  padding: 2px; border: 1px solid #333;
73      ul.text { margin-left: 2em; margin-right: 2em; }                  color: #900; background-color: #EEE;
74      li { margin-left: 3em;  }                  text-align: left;
75            }
76      pre { margin-left: 3em; color: #333333;  background-color: transparent;  
77          font-family: "Courier New", Courier, monospace ; font-size: small ;          a { font-weight: bold; }
78          text-align: left;          a:link    { color: #900; background-color: transparent; }
79          }          a:visited { color: #633; background-color: transparent; }
80            a:active  { color: #633; background-color: transparent; }
81      h3 { color: #333333; font-size: medium ;  
82          font-family: helvetica, arial, sans-serif ;          p { margin-left: 2em; margin-right: 2em; }
83          background-color: transparent; }          p.copyright { font-size: x-small; }
84      h4 { font-size: small; font-family: helvetica, arial, sans-serif ; }          p.toc { font-size: small; font-weight: bold; margin-left: 3em; }
85            table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; }
86      table.bug { width: 30px ; height: 15px ; }          td.toc { font-size: small; font-weight: bold; vertical-align: text-top; }
87      td.bug { color: #ffffff ; background-color: #990000 ;  
88          text-align: center ; width: 30px ; height: 15px ;          ol.text { margin-left: 2em; margin-right: 2em; }
89           }          ul.text { margin-left: 2em; margin-right: 2em; }
90      td.bug A.link2 { color: #ffffff ; font-weight: bold;          li      { margin-left: 3em; }
91          text-decoration: none;  
92          font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif;          /* RFC-2629 <spanx>s and <artwork>s. */
93          font-size: x-small ; background-color: transparent }          em     { font-style: italic; }
94            strong { font-weight: bold; }
95      td.header { color: #ffffff; font-size: x-small ;          dfn    { font-weight: bold; font-style: normal; }
96          font-family: arial, helvetica, sans-serif; vertical-align: top;          cite   { font-weight: normal; font-style: normal; }
97          background-color: #666666 ; width: 33% ; }          tt     { color: #036; }
98      td.author { font-weight: bold; margin-left: 4em; font-size: x-small ; }          tt, pre, pre dfn, pre em, pre cite, pre span {
99      td.author-text { font-size: x-small; }                  font-family: "Courier New", Courier, monospace; font-size: small;
100      table.full { vertical-align: top ; border-collapse: collapse ;          }
101          border-style: solid solid solid solid ;          pre {
102          border-color: black black black black ;                  text-align: left; padding: 4px;
103          font-size: small ; text-align: center ; }                  color: #000; background-color: #CCC;
104      table.headers, table.none { vertical-align: top ; border-collapse: collapse ;          }
105          border-style: none;          pre dfn  { color: #900; }
106          font-size: small ; text-align: center ; }          pre em   { color: #66F; background-color: #FFC; font-weight: normal; }
107      table.full th { font-weight: bold ;          pre .key { color: #33C; font-weight: bold; }
108          border-style: solid ;          pre .id  { color: #900; }
109          border-color: black black black black ; }          pre .str { color: #000; background-color: #CFF; }
110      table.headers th { font-weight: bold ;          pre .val { color: #066; }
111          border-style: none none solid none;          pre .rep { color: #909; }
112          border-color: black black black black ; }          pre .oth { color: #000; background-color: #FCF; }
113      table.none th { font-weight: bold ;          pre .err { background-color: #FCC; }
114          border-style: none; }  
115      table.full td {          /* RFC-2629 <texttable>s. */
116          border-style: solid solid solid solid ;          table.full, table.headers, table.none {
117          border-color: #333333 #333333 #333333 #333333 ; }                  font-size: small; text-align: center; border-width: 2px;
118      table.headers td, table.none td { border-style: none; }                  vertical-align: top; border-collapse: collapse;
119            }
120      hr { height: 1px }          table.full { border-style: solid; border-color: black; }
121  -->          table.headers, table.none { border-style: none; }
122  </style>          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: May 29, 2007</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">November 25, 2006</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 153  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 May 29, 2007.</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 (2006). All Rights Reserved.</p>  Copyright &copy; The Internet Society (2006).</p>
181    
182  <h3>Abstract</h3>  <h3>Abstract</h3>
183    
# Line 278  Current number of active disk streams<br Line 298  Current number of active disk streams<br
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 />
# Line 296  Setting channel volume<br /> Line 316  Setting channel volume<br />
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 />
# Line 318  Maximum amount of active voices<br /> Line 340  Maximum amount of active voices<br />
340  Reset sampler<br />  Reset sampler<br />
341  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.4.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.4.</a>&nbsp;
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 TOTAL_VOICE_COUNT">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 />  Total number of active voices changed<br />
393  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a>&nbsp;  &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 350  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 432  Intellectual Property and Copyright Stat Line 497  Intellectual Property and Copyright Stat
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
# Line 476  Intellectual Property and Copyright Stat Line 542  Intellectual Property and Copyright Stat
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 502  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 514  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 529  Intellectual Property and Copyright Stat Line 598  Intellectual Property and Copyright Stat
598              methods will be described next.              methods will be described next.
599  </p>  </p>
600  <a name="anchor5"></a><br /><hr />  <a name="anchor5"></a><br /><hr />
601  <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>
602  <a name="rfc.section.5.1"></a><h3>5.1.&nbsp;Request/response communication method</h3>  <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 574  Intellectual Property and Copyright Stat Line 644  Intellectual Property and Copyright Stat
644                  MUST be sent back in the same order.                  MUST be sent back in the same order.
645  </p>  </p>
646  <a name="anchor6"></a><br /><hr />  <a name="anchor6"></a><br /><hr />
647  <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>
648  <a name="rfc.section.5.1.1"></a><h3>5.1.1.&nbsp;Result format</h3>  <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 766  Intellectual Property and Copyright Stat Line 837  Intellectual Property and Copyright Stat
837                                            
838  </p>  </p>
839  <a name="anchor7"></a><br /><hr />  <a name="anchor7"></a><br /><hr />
840  <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>
841  <a name="rfc.section.5.2"></a><h3>5.2.&nbsp;Subscribe/notify communication method</h3>  <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 844  Intellectual Property and Copyright Stat Line 916  Intellectual Property and Copyright Stat
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 890  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="anchor8"></a><br /><hr />  <a name="anchor8"></a><br /><hr />
977  <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>
978  <a name="rfc.section.6.1"></a><h3>6.1.&nbsp;Ignored lines and comments</h3>  <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 911  Intellectual Property and Copyright Stat Line 985  Intellectual Property and Copyright Stat
985                  file.                  file.
986  </p>  </p>
987  <a name="anchor9"></a><br /><hr />  <a name="anchor9"></a><br /><hr />
988  <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>
989  <a name="rfc.section.6.2"></a><h3>6.2.&nbsp;Configuring audio drivers</h3>  <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 946  Intellectual Property and Copyright Stat Line 1021  Intellectual Property and Copyright Stat
1021                  possible values, etc.                  possible values, etc.
1022  </p>  </p>
1023  <a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />  <a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
1024  <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>
1025  <a name="rfc.section.6.2.1"></a><h3>6.2.1.&nbsp;Getting amount of available audio output drivers</h3>  <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 985  Intellectual Property and Copyright Stat Line 1061  Intellectual Property and Copyright Stat
1061                                            
1062  </p>  </p>
1063  <a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />  <a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
1064  <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>
1065  <a name="rfc.section.6.2.2"></a><h3>6.2.2.&nbsp;Getting all available audio output drivers</h3>  <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 1025  Intellectual Property and Copyright Stat Line 1102  Intellectual Property and Copyright Stat
1102                                            
1103  </p>  </p>
1104  <a name="GET AUDIO_OUTPUT_DRIVER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DRIVER INFO"></a><br /><hr />
1105  <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>
1106  <a name="rfc.section.6.2.3"></a><h3>6.2.3.&nbsp;Getting information about a specific audio  <a name="rfc.section.6.2.3"></a><h3>6.2.3.&nbsp;
1107    Getting information about a specific audio
1108                  output driver</h3>                  output driver</h3>
1109    
1110  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
# Line 1043  Intellectual Property and Copyright Stat Line 1121  Intellectual Property and Copyright Stat
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 1124  Intellectual Property and Copyright Stat Line 1202  Intellectual Property and Copyright Stat
1202                                            
1203  </p>  </p>
1204  <a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
1205  <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>
1206  <a name="rfc.section.6.2.4"></a><h3>6.2.4.&nbsp;Getting information about specific audio  <a name="rfc.section.6.2.4"></a><h3>6.2.4.&nbsp;
1207    Getting information about specific audio
1208                  output driver parameter</h3>                  output driver parameter</h3>
1209    
1210  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
# Line 1140  Intellectual Property and Copyright Stat Line 1219  Intellectual Property and Copyright Stat
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 1200  Intellectual Property and Copyright Stat Line 1279  Intellectual Property and Copyright Stat
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>  </blockquote>
# Line 1211  Intellectual Property and Copyright Stat Line 1290  Intellectual Property and Copyright Stat
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>  </blockquote>
# Line 1250  Intellectual Property and Copyright Stat Line 1329  Intellectual Property and Copyright Stat
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 (')
# Line 1378  Intellectual Property and Copyright Stat Line 1457  Intellectual Property and Copyright Stat
1457                                            
1458  </p>  </p>
1459  <a name="CREATE AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="CREATE AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1460  <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>
1461  <a name="rfc.section.6.2.5"></a><h3>6.2.5.&nbsp;Creating an audio output device</h3>  <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 1393  Intellectual Property and Copyright Stat Line 1473  Intellectual Property and Copyright Stat
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 1462  Intellectual Property and Copyright Stat Line 1542  Intellectual Property and Copyright Stat
1542                                            
1543  </p>  </p>
1544  <a name="DESTROY AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="DESTROY AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1545  <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>
1546  <a name="rfc.section.6.2.6"></a><h3>6.2.6.&nbsp;Destroying an audio output device</h3>  <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 1477  Intellectual Property and Copyright Stat Line 1558  Intellectual Property and Copyright Stat
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 1531  Intellectual Property and Copyright Stat Line 1612  Intellectual Property and Copyright Stat
1612                                            
1613  </p>  </p>
1614  <a name="GET AUDIO_OUTPUT_DEVICES"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1615  <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>
1616  <a name="rfc.section.6.2.7"></a><h3>6.2.7.&nbsp;Getting all created audio output device count</h3>  <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 1568  Intellectual Property and Copyright Stat Line 1650  Intellectual Property and Copyright Stat
1650                                            
1651  </p>  </p>
1652  <a name="LIST AUDIO_OUTPUT_DEVICES"></a><br /><hr />  <a name="LIST AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1653  <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>
1654  <a name="rfc.section.6.2.8"></a><h3>6.2.8.&nbsp;Getting all created audio output device list</h3>  <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 1605  Intellectual Property and Copyright Stat Line 1688  Intellectual Property and Copyright Stat
1688                                            
1689  </p>  </p>
1690  <a name="GET AUDIO_OUTPUT_DEVICE INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DEVICE INFO"></a><br /><hr />
1691  <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>
1692  <a name="rfc.section.6.2.9"></a><h3>6.2.9.&nbsp;Getting current settings of an audio output device</h3>  <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 1620  Intellectual Property and Copyright Stat Line 1704  Intellectual Property and Copyright Stat
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 1640  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>  </blockquote>
# Line 1681  Intellectual Property and Copyright Stat Line 1765  Intellectual Property and Copyright Stat
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 1711  Intellectual Property and Copyright Stat Line 1795  Intellectual Property and Copyright Stat
1795                                            
1796  </p>  </p>
1797  <a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER"></a><br /><hr />  <a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER"></a><br /><hr />
1798  <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>
1799  <a name="rfc.section.6.2.10"></a><h3>6.2.10.&nbsp;Changing settings of audio output devices</h3>  <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 1726  Intellectual Property and Copyright Stat Line 1811  Intellectual Property and Copyright Stat
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 1779  Intellectual Property and Copyright Stat Line 1864  Intellectual Property and Copyright Stat
1864                                            
1865  </p>  </p>
1866  <a name="GET AUDIO_OUTPUT_CHANNEL INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_CHANNEL INFO"></a><br /><hr />
1867  <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>
1868  <a name="rfc.section.6.2.11"></a><h3>6.2.11.&nbsp;Getting information about an audio channel</h3>  <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 1793  Intellectual Property and Copyright Stat Line 1879  Intellectual Property and Copyright Stat
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 1921  Intellectual Property and Copyright Stat Line 2007  Intellectual Property and Copyright Stat
2007                                            
2008  </p>  </p>
2009  <a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO"></a><br /><hr />
2010  <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>
2011  <a name="rfc.section.6.2.12"></a><h3>6.2.12.&nbsp;Getting information about specific audio channel parameter</h3>  <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 1935  Intellectual Property and Copyright Stat Line 2022  Intellectual Property and Copyright Stat
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 2067  Intellectual Property and Copyright Stat Line 2154  Intellectual Property and Copyright Stat
2154                                            
2155  </p>  </p>
2156  <a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER"></a><br /><hr />  <a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER"></a><br /><hr />
2157  <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>
2158  <a name="rfc.section.6.2.13"></a><h3>6.2.13.&nbsp;Changing settings of audio output channels</h3>  <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 2081  Intellectual Property and Copyright Stat Line 2169  Intellectual Property and Copyright Stat
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 2144  Intellectual Property and Copyright Stat Line 2232  Intellectual Property and Copyright Stat
2232                                            
2233  </p>  </p>
2234  <a name="anchor10"></a><br /><hr />  <a name="anchor10"></a><br /><hr />
2235  <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>
2236  <a name="rfc.section.6.3"></a><h3>6.3.&nbsp;Configuring MIDI input drivers</h3>  <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 2174  Intellectual Property and Copyright Stat Line 2263  Intellectual Property and Copyright Stat
2263                  possible values, etc.                  possible values, etc.
2264  </p>  </p>
2265  <a name="GET AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />  <a name="GET AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2266  <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>
2267  <a name="rfc.section.6.3.1"></a><h3>6.3.1.&nbsp;Getting amount of available MIDI input drivers</h3>  <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 2213  Intellectual Property and Copyright Stat Line 2303  Intellectual Property and Copyright Stat
2303                                            
2304  </p>  </p>
2305  <a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />  <a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2306  <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>
2307  <a name="rfc.section.6.3.2"></a><h3>6.3.2.&nbsp;Getting all available MIDI input drivers</h3>  <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 2251  Intellectual Property and Copyright Stat Line 2342  Intellectual Property and Copyright Stat
2342                                            
2343  </p>  </p>
2344  <a name="GET MIDI_INPUT_DRIVER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DRIVER INFO"></a><br /><hr />
2345  <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>
2346  <a name="rfc.section.6.3.3"></a><h3>6.3.3.&nbsp;Getting information about a specific MIDI input driver</h3>  <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 2265  Intellectual Property and Copyright Stat Line 2357  Intellectual Property and Copyright Stat
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 2332  Intellectual Property and Copyright Stat Line 2424  Intellectual Property and Copyright Stat
2424                                            
2425  </p>  </p>
2426  <a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
2427  <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>
2428  <a name="rfc.section.6.3.4"></a><h3>6.3.4.&nbsp;Getting information about specific MIDI input driver parameter</h3>  <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 2346  Intellectual Property and Copyright Stat Line 2439  Intellectual Property and Copyright Stat
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 2395  Intellectual Property and Copyright Stat Line 2488  Intellectual Property and Copyright Stat
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>  </blockquote>
# Line 2406  Intellectual Property and Copyright Stat Line 2499  Intellectual Property and Copyright Stat
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>  </blockquote>
# Line 2445  Intellectual Property and Copyright Stat Line 2538  Intellectual Property and Copyright Stat
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 (')
# Line 2519  Intellectual Property and Copyright Stat Line 2612  Intellectual Property and Copyright Stat
2612                                            
2613  </p>  </p>
2614  <a name="CREATE MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="CREATE MIDI_INPUT_DEVICE"></a><br /><hr />
2615  <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>
2616  <a name="rfc.section.6.3.5"></a><h3>6.3.5.&nbsp;Creating a MIDI input device</h3>  <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 2533  Intellectual Property and Copyright Stat Line 2627  Intellectual Property and Copyright Stat
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 2589  Intellectual Property and Copyright Stat Line 2683  Intellectual Property and Copyright Stat
2683                                            
2684  </p>  </p>
2685  <a name="DESTROY MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="DESTROY MIDI_INPUT_DEVICE"></a><br /><hr />
2686  <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>
2687  <a name="rfc.section.6.3.6"></a><h3>6.3.6.&nbsp;Destroying a MIDI input device</h3>  <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 2603  Intellectual Property and Copyright Stat Line 2698  Intellectual Property and Copyright Stat
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 2654  Intellectual Property and Copyright Stat Line 2749  Intellectual Property and Copyright Stat
2749                                            
2750  </p>  </p>
2751  <a name="GET MIDI_INPUT_DEVICES"></a><br /><hr />  <a name="GET MIDI_INPUT_DEVICES"></a><br /><hr />
2752  <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>
2753  <a name="rfc.section.6.3.7"></a><h3>6.3.7.&nbsp;Getting all created MIDI input device count</h3>  <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 2691  Intellectual Property and Copyright Stat Line 2787  Intellectual Property and Copyright Stat
2787                                            
2788  </p>  </p>
2789  <a name="LIST MIDI_INPUT_DEVICES"></a><br /><hr />  <a name="LIST MIDI_INPUT_DEVICES"></a><br /><hr />
2790  <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>
2791  <a name="rfc.section.6.3.8"></a><h3>6.3.8.&nbsp;Getting all created MIDI input device list</h3>  <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 2738  Intellectual Property and Copyright Stat Line 2835  Intellectual Property and Copyright Stat
2835                                            
2836  </p>  </p>
2837  <a name="GET MIDI_INPUT_DEVICE INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DEVICE INFO"></a><br /><hr />
2838  <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>
2839  <a name="rfc.section.6.3.9"></a><h3>6.3.9.&nbsp;Getting current settings of a MIDI input device</h3>  <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 2752  Intellectual Property and Copyright Stat Line 2850  Intellectual Property and Copyright Stat
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 2776  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>  </blockquote>
# Line 2806  Intellectual Property and Copyright Stat Line 2904  Intellectual Property and Copyright Stat
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 2826  Intellectual Property and Copyright Stat Line 2924  Intellectual Property and Copyright Stat
2924                                            
2925  </p>  </p>
2926  <a name="SET MIDI_INPUT_DEVICE_PARAMETER"></a><br /><hr />  <a name="SET MIDI_INPUT_DEVICE_PARAMETER"></a><br /><hr />
2927  <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>
2928  <a name="rfc.section.6.3.10"></a><h3>6.3.10.&nbsp;Changing settings of MIDI input devices</h3>  <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 2841  Intellectual Property and Copyright Stat Line 2940  Intellectual Property and Copyright Stat
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 2893  Intellectual Property and Copyright Stat Line 2992  Intellectual Property and Copyright Stat
2992                                            
2993  </p>  </p>
2994  <a name="GET MIDI_INPUT_PORT INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_PORT INFO"></a><br /><hr />
2995  <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>
2996  <a name="rfc.section.6.3.11"></a><h3>6.3.11.&nbsp;Getting information about a MIDI port</h3>  <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 2907  Intellectual Property and Copyright Stat Line 3007  Intellectual Property and Copyright Stat
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 2955  Intellectual Property and Copyright Stat Line 3055  Intellectual Property and Copyright Stat
3055                                            
3056  </p>  </p>
3057  <a name="GET MIDI_INPUT_PORT_PARAMETER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_PORT_PARAMETER INFO"></a><br /><hr />
3058  <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>
3059  <a name="rfc.section.6.3.12"></a><h3>6.3.12.&nbsp;Getting information about specific MIDI port parameter</h3>  <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 2969  Intellectual Property and Copyright Stat Line 3070  Intellectual Property and Copyright Stat
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 3096  Intellectual Property and Copyright Stat Line 3197  Intellectual Property and Copyright Stat
3197                                            
3198  </p>  </p>
3199  <a name="SET MIDI_INPUT_PORT_PARAMETER"></a><br /><hr />  <a name="SET MIDI_INPUT_PORT_PARAMETER"></a><br /><hr />
3200  <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>
3201  <a name="rfc.section.6.3.13"></a><h3>6.3.13.&nbsp;Changing settings of MIDI input ports</h3>  <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 3111  Intellectual Property and Copyright Stat Line 3213  Intellectual Property and Copyright Stat
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 3162  Intellectual Property and Copyright Stat Line 3264  Intellectual Property and Copyright Stat
3264                                            
3265  </p>  </p>
3266  <a name="anchor11"></a><br /><hr />  <a name="anchor11"></a><br /><hr />
3267  <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>
3268  <a name="rfc.section.6.4"></a><h3>6.4.&nbsp;Configuring sampler channels</h3>  <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="LOAD INSTRUMENT"></a><br /><hr />  <a name="LOAD INSTRUMENT"></a><br /><hr />
3276  <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>
3277  <a name="rfc.section.6.4.1"></a><h3>6.4.1.&nbsp;Loading an instrument</h3>  <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 3193  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 3247  Intellectual Property and Copyright Stat Line 3351  Intellectual Property and Copyright Stat
3351                                            
3352  </p>  </p>
3353  <a name="LOAD ENGINE"></a><br /><hr />  <a name="LOAD ENGINE"></a><br /><hr />
3354  <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>
3355  <a name="rfc.section.6.4.2"></a><h3>6.4.2.&nbsp;Loading a sampler engine</h3>  <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 3262  Intellectual Property and Copyright Stat Line 3367  Intellectual Property and Copyright Stat
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 3321  Intellectual Property and Copyright Stat Line 3426  Intellectual Property and Copyright Stat
3426                                            
3427  </p>  </p>
3428  <a name="GET CHANNELS"></a><br /><hr />  <a name="GET CHANNELS"></a><br /><hr />
3429  <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>
3430  <a name="rfc.section.6.4.3"></a><h3>6.4.3.&nbsp;Getting all created sampler channel count</h3>  <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 3359  Intellectual Property and Copyright Stat Line 3465  Intellectual Property and Copyright Stat
3465                                            
3466  </p>  </p>
3467  <a name="LIST CHANNELS"></a><br /><hr />  <a name="LIST CHANNELS"></a><br /><hr />
3468  <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>
3469  <a name="rfc.section.6.4.4"></a><h3>6.4.4.&nbsp;Getting all created sampler channel list</h3>  <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 3398  Intellectual Property and Copyright Stat Line 3505  Intellectual Property and Copyright Stat
3505                                            
3506  </p>  </p>
3507  <a name="ADD CHANNEL"></a><br /><hr />  <a name="ADD CHANNEL"></a><br /><hr />
3508  <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>
3509  <a name="rfc.section.6.4.5"></a><h3>6.4.5.&nbsp;Adding a new sampler channel</h3>  <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 3472  Intellectual Property and Copyright Stat Line 3580  Intellectual Property and Copyright Stat
3580                                            
3581  </p>  </p>
3582  <a name="REMOVE CHANNEL"></a><br /><hr />  <a name="REMOVE CHANNEL"></a><br /><hr />
3583  <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>
3584  <a name="rfc.section.6.4.6"></a><h3>6.4.6.&nbsp;Removing a sampler channel</h3>  <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 3487  Intellectual Property and Copyright Stat Line 3596  Intellectual Property and Copyright Stat
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 3538  Intellectual Property and Copyright Stat Line 3647  Intellectual Property and Copyright Stat
3647                                            
3648  </p>  </p>
3649  <a name="GET AVAILABLE_ENGINES"></a><br /><hr />  <a name="GET AVAILABLE_ENGINES"></a><br /><hr />
3650  <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>
3651  <a name="rfc.section.6.4.7"></a><h3>6.4.7.&nbsp;Getting amount of available engines</h3>  <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 3574  Intellectual Property and Copyright Stat Line 3684  Intellectual Property and Copyright Stat
3684                                            
3685  </p>  </p>
3686  <a name="LIST AVAILABLE_ENGINES"></a><br /><hr />  <a name="LIST AVAILABLE_ENGINES"></a><br /><hr />
3687  <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>
3688  <a name="rfc.section.6.4.8"></a><h3>6.4.8.&nbsp;Getting all available engines</h3>  <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 3613  Intellectual Property and Copyright Stat Line 3724  Intellectual Property and Copyright Stat
3724                                            
3725  </p>  </p>
3726  <a name="GET ENGINE INFO"></a><br /><hr />  <a name="GET ENGINE INFO"></a><br /><hr />
3727  <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>
3728  <a name="rfc.section.6.4.9"></a><h3>6.4.9.&nbsp;Getting information about an engine</h3>  <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 3628  Intellectual Property and Copyright Stat Line 3740  Intellectual Property and Copyright Stat
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 3685  Intellectual Property and Copyright Stat Line 3797  Intellectual Property and Copyright Stat
3797                                            
3798  </p>  </p>
3799  <a name="GET CHANNEL INFO"></a><br /><hr />  <a name="GET CHANNEL INFO"></a><br /><hr />
3800  <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>
3801  <a name="rfc.section.6.4.10"></a><h3>6.4.10.&nbsp;Getting sampler channel information</h3>  <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 3700  Intellectual Property and Copyright Stat Line 3813  Intellectual Property and Copyright Stat
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 3856  Intellectual Property and Copyright Stat Line 3969  Intellectual Property and Copyright Stat
3969  </blockquote>  </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>
3980    </blockquote>
3981                                        
3982    
3983  </blockquote>  </blockquote>
3984                                                            
3985    
# Line 3895  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="GET CHANNEL VOICE_COUNT"></a><br /><hr />  <a name="GET CHANNEL VOICE_COUNT"></a><br /><hr />
4036  <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>
4037  <a name="rfc.section.6.4.11"></a><h3>6.4.11.&nbsp;Current number of active voices</h3>  <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 3916  Intellectual Property and Copyright Stat Line 4049  Intellectual Property and Copyright Stat
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 3941  Intellectual Property and Copyright Stat Line 4074  Intellectual Property and Copyright Stat
4074                                            
4075  </p>  </p>
4076  <a name="GET CHANNEL STREAM_COUNT"></a><br /><hr />  <a name="GET CHANNEL STREAM_COUNT"></a><br /><hr />
4077  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <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;Current number of active disk streams</h3>  <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 3956  Intellectual Property and Copyright Stat Line 4090  Intellectual Property and Copyright Stat
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 3983  Intellectual Property and Copyright Stat Line 4117  Intellectual Property and Copyright Stat
4117                                            
4118  </p>  </p>
4119  <a name="GET CHANNEL BUFFER_FILL"></a><br /><hr />  <a name="GET CHANNEL BUFFER_FILL"></a><br /><hr />
4120  <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>
4121  <a name="rfc.section.6.4.13"></a><h3>6.4.13.&nbsp;Current fill state of disk stream buffers</h3>  <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 4009  Intellectual Property and Copyright Stat Line 4144  Intellectual Property and Copyright Stat
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 4060  Intellectual Property and Copyright Stat Line 4195  Intellectual Property and Copyright Stat
4195                                            
4196  </p>  </p>
4197  <a name="SET CHANNEL AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_DEVICE"></a><br /><hr />
4198  <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>
4199  <a name="rfc.section.6.4.14"></a><h3>6.4.14.&nbsp;Setting audio output device</h3>  <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 4075  Intellectual Property and Copyright Stat Line 4211  Intellectual Property and Copyright Stat
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 4126  Intellectual Property and Copyright Stat Line 4262  Intellectual Property and Copyright Stat
4262  </blockquote><p>  </blockquote><p>
4263                                            
4264  </p>  </p>
4265  <a name="SET CHANNEL AUDIO_OUTPUT_TYP"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_TYPE"></a><br /><hr />
4266  <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>
4267  <a name="rfc.section.6.4.15"></a><h3>6.4.15.&nbsp;Setting audio output type</h3>  <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 4191  Intellectual Property and Copyright Stat Line 4328  Intellectual Property and Copyright Stat
4328                                            
4329  </p>  </p>
4330  <a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr />
4331  <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>
4332  <a name="rfc.section.6.4.16"></a><h3>6.4.16.&nbsp;Setting audio output channel</h3>  <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 4206  Intellectual Property and Copyright Stat Line 4344  Intellectual Property and Copyright Stat
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 4257  Intellectual Property and Copyright Stat Line 4395  Intellectual Property and Copyright Stat
4395                                            
4396  </p>  </p>
4397  <a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr />
4398  <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>
4399  <a name="rfc.section.6.4.17"></a><h3>6.4.17.&nbsp;Setting MIDI input device</h3>  <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 4272  Intellectual Property and Copyright Stat Line 4411  Intellectual Property and Copyright Stat
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 4323  Intellectual Property and Copyright Stat Line 4462  Intellectual Property and Copyright Stat
4462                                            
4463  </p>  </p>
4464  <a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr />
4465  <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>
4466  <a name="rfc.section.6.4.18"></a><h3>6.4.18.&nbsp;Setting MIDI input type</h3>  <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 4387  Intellectual Property and Copyright Stat Line 4527  Intellectual Property and Copyright Stat
4527                                            
4528  </p>  </p>
4529  <a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr />
4530  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <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;Setting MIDI input port</h3>  <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 4450  Intellectual Property and Copyright Stat Line 4591  Intellectual Property and Copyright Stat
4591                                            
4592  </p>  </p>
4593  <a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr />
4594  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <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;Setting MIDI input channel</h3>  <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 4513  Intellectual Property and Copyright Stat Line 4655  Intellectual Property and Copyright Stat
4655                                            
4656  </p>  </p>
4657  <a name="SET CHANNEL VOLUME"></a><br /><hr />  <a name="SET CHANNEL VOLUME"></a><br /><hr />
4658  <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>
4659  <a name="rfc.section.6.4.21"></a><h3>6.4.21.&nbsp;Setting channel volume</h3>  <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 4577  Intellectual Property and Copyright Stat Line 4720  Intellectual Property and Copyright Stat
4720                                            
4721  </p>  </p>
4722  <a name="SET CHANNEL MUTE"></a><br /><hr />  <a name="SET CHANNEL MUTE"></a><br /><hr />
4723  <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>
4724  <a name="rfc.section.6.4.22"></a><h3>6.4.22.&nbsp;Muting a sampler channel</h3>  <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 4592  Intellectual Property and Copyright Stat Line 4736  Intellectual Property and Copyright Stat
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 4642  Intellectual Property and Copyright Stat Line 4786  Intellectual Property and Copyright Stat
4786                                            
4787  </p>  </p>
4788  <a name="SET CHANNEL SOLO"></a><br /><hr />  <a name="SET CHANNEL SOLO"></a><br /><hr />
4789  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <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;Soloing a sampler channel</h3>  <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 4657  Intellectual Property and Copyright Stat Line 4802  Intellectual Property and Copyright Stat
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 4706  Intellectual Property and Copyright Stat Line 4851  Intellectual Property and Copyright Stat
4851  </blockquote><p>  </blockquote><p>
4852                                            
4853  </p>  </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>
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>
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>
4942    <p>Examples:
4943    </p>
4944    <p>
4945                            </p>
4946    <blockquote class="text">
4947    <p>
4948    </p>
4949    </blockquote><p>
4950                        
4951    </p>
4952  <a name="RESET CHANNEL"></a><br /><hr />  <a name="RESET CHANNEL"></a><br /><hr />
4953  <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>
4954  <a name="rfc.section.6.4.24"></a><h3>6.4.24.&nbsp;Resetting a sampler channel</h3>  <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 4772  Intellectual Property and Copyright Stat Line 5016  Intellectual Property and Copyright Stat
5016                                            
5017  </p>  </p>
5018  <a name="anchor12"></a><br /><hr />  <a name="anchor12"></a><br /><hr />
5019  <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>
5020  <a name="rfc.section.6.5"></a><h3>6.5.&nbsp;Controlling connection</h3>  <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="SUBSCRIBE"></a><br /><hr />  <a name="SUBSCRIBE"></a><br /><hr />
5026  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <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;Register front-end for receiving event messages</h3>  <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 4841  Intellectual Property and Copyright Stat Line 5087  Intellectual Property and Copyright Stat
5087                                            
5088  </p>  </p>
5089  <a name="UNSUBSCRIBE"></a><br /><hr />  <a name="UNSUBSCRIBE"></a><br /><hr />
5090  <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>
5091  <a name="rfc.section.6.5.2"></a><h3>6.5.2.&nbsp;Unregister front-end for not receiving event messages</h3>  <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 4904  Intellectual Property and Copyright Stat Line 5151  Intellectual Property and Copyright Stat
5151                                            
5152  </p>  </p>
5153  <a name="SET ECHO"></a><br /><hr />  <a name="SET ECHO"></a><br /><hr />
5154  <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>
5155  <a name="rfc.section.6.5.3"></a><h3>6.5.3.&nbsp;Enable or disable echo of commands</h3>  <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 4960  Intellectual Property and Copyright Stat Line 5208  Intellectual Property and Copyright Stat
5208                                            
5209  </p>  </p>
5210  <a name="QUIT"></a><br /><hr />  <a name="QUIT"></a><br /><hr />
5211  <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>
5212  <a name="rfc.section.6.5.4"></a><h3>6.5.4.&nbsp;Close client connection</h3>  <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 4977  Intellectual Property and Copyright Stat Line 5226  Intellectual Property and Copyright Stat
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="anchor13"></a><br /><hr />  <a name="anchor13"></a><br /><hr />
5229  <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>
5230  <a name="rfc.section.6.6"></a><h3>6.6.&nbsp;Global commands</h3>  <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="GET TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="GET TOTAL_VOICE_COUNT"></a><br /><hr />
5236  <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>
5237  <a name="rfc.section.6.6.1"></a><h3>6.6.1.&nbsp;Current number of active voices</h3>  <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  <p>The front-end can ask for the current number of active voices on
5241                      the sampler by sending the following command:                      the sampler by sending the following command:
# Line 5009  Intellectual Property and Copyright Stat Line 5260  Intellectual Property and Copyright Stat
5260                                            
5261  </p>  </p>
5262  <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />  <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />
5263  <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>
5264  <a name="rfc.section.6.6.2"></a><h3>6.6.2.&nbsp;Maximum amount of active voices</h3>  <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  <p>The front-end can ask for the maximum number of active voices
5268                      by sending the following command:                      by sending the following command:
# Line 5035  Intellectual Property and Copyright Stat Line 5287  Intellectual Property and Copyright Stat
5287                                            
5288  </p>  </p>
5289  <a name="RESET"></a><br /><hr />  <a name="RESET"></a><br /><hr />
5290  <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>
5291  <a name="rfc.section.6.6.3"></a><h3>6.6.3.&nbsp;Reset sampler</h3>  <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 5075  Intellectual Property and Copyright Stat Line 5328  Intellectual Property and Copyright Stat
5328                                            
5329  </p>  </p>
5330  <a name="GET SERVER INFO"></a><br /><hr />  <a name="GET SERVER INFO"></a><br /><hr />
5331  <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>
5332  <a name="rfc.section.6.6.4"></a><h3>6.6.4.&nbsp;General sampler informations</h3>  <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 5124  Intellectual Property and Copyright Stat Line 5378  Intellectual Property and Copyright Stat
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>  </p>
5383  </blockquote>  </blockquote>
5384                                                                            
# Line 5138  Intellectual Property and Copyright Stat Line 5392  Intellectual Property and Copyright Stat
5392  <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.
5393                      Other fields might be added in future.                      Other fields might be added in future.
5394  </p>  </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>
5678    </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>
5728    </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>
5744    </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>
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.
6289    </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>
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>
# Line 5201  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
# Line 5219  Intellectual Property and Copyright Stat Line 6476  Intellectual Property and Copyright Stat
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
# Line 5234  Intellectual Property and Copyright Stat Line 6491  Intellectual Property and Copyright Stat
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
# Line 5246  Intellectual Property and Copyright Stat Line 6506  Intellectual Property and Copyright Stat
6506  </blockquote><p>  </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>
6522    
6523    </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
# Line 5264  Intellectual Property and Copyright Stat Line 6551  Intellectual Property and Copyright Stat
6551  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
6552                                    
6553  </p>  </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>
6566  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
6567                                    
6568  </p>  </p>
# Line 5276  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
# Line 5291  Intellectual Property and Copyright Stat Line 6602  Intellectual Property and Copyright Stat
6602  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
6603                                    
6604  </p>  </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>
6617  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
6618                                    
6619  </p>  </p>
# Line 5300  Intellectual Property and Copyright Stat Line 6623  Intellectual Property and Copyright Stat
6623  </blockquote><p>  </blockquote><p>
6624    
6625  </p>  </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>
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>
6666    
6667    </p>
6668  <p>get_instruction =  <p>get_instruction =
6669          </p>          </p>
6670  <blockquote class="text">  <blockquote class="text">
# Line 5381  Intellectual Property and Copyright Stat Line 6746  Intellectual Property and Copyright Stat
6746  <p>/ TOTAL_VOICE_COUNT_MAX  <p>/ TOTAL_VOICE_COUNT_MAX
6747                                    
6748  </p>  </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>
6764  </blockquote><p>  </blockquote><p>
6765    
6766  </p>  </p>
# Line 5402  Intellectual Property and Copyright Stat Line 6782  Intellectual Property and Copyright Stat
6782  <p>/ CHANNEL SP set_chan_instruction  <p>/ CHANNEL SP set_chan_instruction
6783                                    
6784  </p>  </p>
6785    <p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name
6786                    
6787    </p>
6788  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
6789                                    
6790  </p>  </p>
# Line 5426  Intellectual Property and Copyright Stat Line 6809  Intellectual Property and Copyright Stat
6809  </blockquote><p>  </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>
6831    
6832    </p>
6833  <p>destroy_instruction =  <p>destroy_instruction =
6834          </p>          </p>
6835  <blockquote class="text">  <blockquote class="text">
# Line 5486  Intellectual Property and Copyright Stat Line 6890  Intellectual Property and Copyright Stat
6890  <p>/ SOLO SP sampler_channel SP boolean  <p>/ SOLO SP sampler_channel SP boolean
6891                                    
6892  </p>  </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>
6902  </blockquote><p>  </blockquote><p>
6903    
6904  </p>  </p>
# Line 5534  Intellectual Property and Copyright Stat Line 6947  Intellectual Property and Copyright Stat
6947  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS
6948                                    
6949  </p>  </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>
6959  </blockquote><p>  </blockquote><p>
6960    
6961  </p>  </p>
# Line 5558  Intellectual Property and Copyright Stat Line 6980  Intellectual Property and Copyright Stat
6980  </blockquote><p>  </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>
6996    
6997    </p>
6998  <p>device_index =  <p>device_index =
6999          </p>          </p>
7000  <blockquote class="text">  <blockquote class="text">
# Line 5615  Intellectual Property and Copyright Stat Line 7052  Intellectual Property and Copyright Stat
7052  </blockquote><p>  </blockquote><p>
7053    
7054  </p>  </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>
7073    <p>midi_prog =
7074            </p>
7075    <blockquote class="text">
7076    <p>number
7077                    
7078    </p>
7079    </blockquote><p>
7080    
7081    </p>
7082  <p>volume_value =  <p>volume_value =
7083          </p>          </p>
7084  <blockquote class="text">  <blockquote class="text">
# Line 5663  Intellectual Property and Copyright Stat Line 7127  Intellectual Property and Copyright Stat
7127  </blockquote><p>  </blockquote><p>
7128    
7129  </p>  </p>
7130    <p>map_name =
7131            </p>
7132    <blockquote class="text">
7133    <p>stringval
7134                    
7135    </p>
7136    </blockquote><p>
7137    
7138    </p>
7139    <p>entry_name =
7140            </p>
7141    <blockquote class="text">
7142    <p>stringval
7143                    
7144    </p>
7145    </blockquote><p>
7146    
7147    </p>
7148  <p>param_val_list =  <p>param_val_list =
7149          </p>          </p>
7150  <blockquote class="text">  <blockquote class="text">
# Line 5694  Intellectual Property and Copyright Stat Line 7176  Intellectual Property and Copyright Stat
7176    
7177  </p>  </p>
7178  <a name="events"></a><br /><hr />  <a name="events"></a><br /><hr />
7179  <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>
7180  <a name="rfc.section.8"></a><h3>8.&nbsp;Events</h3>  <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.  <p>This chapter will describe all currently defined events supported by LinuxSampler.
7184  </p>  </p>
7185  <a name="SUBSCRIBE CHANNEL"></a><br /><hr />  <a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT"></a><br /><hr />
7186  <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>
7187  <a name="rfc.section.8.1"></a><h3>8.1.&nbsp;Number of sampler channels changed</h3>  <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>
7193    <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>
7237    </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>
7255    <p>
7256                        </p>
7257    <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>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>
7309    <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 5728  Intellectual Property and Copyright Stat Line 7336  Intellectual Property and Copyright Stat
7336                  of sampler channels.                  of sampler channels.
7337  </p>  </p>
7338  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
7339  <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>
7340  <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;Number of active voices changed</h3>  <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 5757  Intellectual Property and Copyright Stat Line 7366  Intellectual Property and Copyright Stat
7366                  active voices on that channel.                  active voices on that channel.
7367  </p>  </p>
7368  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />
7369  <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>
7370  <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;Number of active disk streams changed</h3>  <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 5786  Intellectual Property and Copyright Stat Line 7396  Intellectual Property and Copyright Stat
7396                  active disk streams on that channel.                  active disk streams on that channel.
7397  </p>  </p>
7398  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />
7399  <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>
7400  <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;Disk stream buffer fill state changed</h3>  <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 5812  Intellectual Property and Copyright Stat Line 7423  Intellectual Property and Copyright Stat
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="SUBSCRIBE INFO"></a><br /><hr />  <a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr />
7430  <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>
7431  <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;Channel information changed</h3>  <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 5848  Intellectual Property and Copyright Stat Line 7460  Intellectual Property and Copyright Stat
7460                  message is sufficient here.                  message is sufficient here.
7461  </p>  </p>
7462  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
7463  <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>
7464  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;Total number of active voices changed</h3>  <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  <p>Client may want to be notified when the total number of voices on the
7468                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 5875  Intellectual Property and Copyright Stat Line 7488  Intellectual Property and Copyright Stat
7488  <p>where &lt;voices&gt; will be replaced by the new number of  <p>where &lt;voices&gt; will be replaced by the new number of
7489                  all currently active voices.                  all currently active voices.
7490  </p>  </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 />  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
7618  <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>
7619  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;Miscellaneous and debugging events</h3>  <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 5905  Intellectual Property and Copyright Stat Line 7645  Intellectual Property and Copyright Stat
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 5914  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 5936  Intellectual Property and Copyright Stat Line 7678  Intellectual Property and Copyright Stat
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 5948  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 5966  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 (2006). 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.940  
changed lines
  Added in v.992
  ViewVC Help
Powered by ViewVC