/[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 973 by schoenebeck, Sun Nov 26 16:39:49 2006 UTC revision 974 by schoenebeck, Fri Dec 15 21:46:48 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 30, 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 26, 2006</td></tr>  <tr><td class="header">Expires: June 18, 2007</td><td class="header">December 15, 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.2</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 30, 2007.</p>  This Internet-Draft will expire on June 18, 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="#anchor14">6.7.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#MIDI Instrument Mapping">6.7.</a>&nbsp;
344  MIDI Instrument Mapping<br />  MIDI Instrument Mapping<br />
345  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#MAP MIDI_INSTRUMENT">6.7.1.</a>&nbsp;  &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 />  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.2.</a>&nbsp;  &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 />  Getting ammount of MIDI instrument map entries<br />
361  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INSTRUMENTS">6.7.3.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INSTRUMENTS">6.7.9.</a>&nbsp;
362  Getting indeces of all MIDI instrument map entries<br />  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.4.</a>&nbsp;  &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 />  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.5.</a>&nbsp;  &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 />  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.6.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CLEAR MIDI_INSTRUMENTS">6.7.12.</a>&nbsp;
368  Clear MIDI instrument map<br />  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 />
# Line 350  Channel information changed<br /> Line 384  Channel information changed<br />
384  Total number of active voices changed<br />  Total number of active voices changed<br />
385  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a>&nbsp;
386  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
387  <a href="#anchor15">9.</a>&nbsp;  <a href="#anchor14">9.</a>&nbsp;
388  Security Considerations<br />  Security Considerations<br />
389  <a href="#anchor16">10.</a>&nbsp;  <a href="#anchor15">10.</a>&nbsp;
390  Acknowledgments<br />  Acknowledgments<br />
391  <a href="#rfc.references1">11.</a>&nbsp;  <a href="#rfc.references1">11.</a>&nbsp;
392  References<br />  References<br />
# Line 364  Intellectual Property and Copyright Stat Line 398  Intellectual Property and Copyright Stat
398  <br clear="all" />  <br clear="all" />
399    
400  <a name="anchor1"></a><br /><hr />  <a name="anchor1"></a><br /><hr />
401  <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>
402  <a name="rfc.section.1"></a><h3>1.&nbsp;Requirements notation</h3>  <a name="rfc.section.1"></a><h3>1.&nbsp;
403    Requirements notation</h3>
404    
405  <p>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL",  <p>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL",
406              "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",              "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",
407              and "OPTIONAL" in this document are to be interpreted as              and "OPTIONAL" in this document are to be interpreted as
408              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>.
409  </p>  </p>
410  <p>This protocol is always case-sensitive if not explicitly  <p>This protocol is always case-sensitive if not explicitly
411              claimed the opposite.              claimed the opposite.
# Line 446  Intellectual Property and Copyright Stat Line 481  Intellectual Property and Copyright Stat
481              return and line feed characters respectively.              return and line feed characters respectively.
482  </p>  </p>
483  <a name="LSCP versioning"></a><br /><hr />  <a name="LSCP versioning"></a><br /><hr />
484  <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>
485  <a name="rfc.section.2"></a><h3>2.&nbsp;Versioning of this specification</h3>  <a name="rfc.section.2"></a><h3>2.&nbsp;
486    Versioning of this specification</h3>
487    
488  <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
489              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 490  Intellectual Property and Copyright Stat Line 526  Intellectual Property and Copyright Stat
526  <p>  <p>
527              Compatibility can only be claimed if both rules are true.              Compatibility can only be claimed if both rules are true.
528              The frontend can use the              The frontend can use the
529              <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
530              get the version of the LSCP specification the sampler complies with.              get the version of the LSCP specification the sampler complies with.
531                            
532  </p>  </p>
533  <a name="anchor2"></a><br /><hr />  <a name="anchor2"></a><br /><hr />
534  <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>
535  <a name="rfc.section.3"></a><h3>3.&nbsp;Introduction</h3>  <a name="rfc.section.3"></a><h3>3.&nbsp;
536    Introduction</h3>
537    
538  <p>LinuxSampler is a so called software sampler application  <p>LinuxSampler is a so called software sampler application
539              capable to playback audio samples from a computer's Random              capable to playback audio samples from a computer's Random
# Line 516  Intellectual Property and Copyright Stat Line 553  Intellectual Property and Copyright Stat
553              there.              there.
554  </p>  </p>
555  <a name="anchor3"></a><br /><hr />  <a name="anchor3"></a><br /><hr />
556  <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>
557  <a name="rfc.section.4"></a><h3>4.&nbsp;Focus of this protocol</h3>  <a name="rfc.section.4"></a><h3>4.&nbsp;
558    Focus of this protocol</h3>
559    
560  <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
561              a running LinuxSampler instance and to retrieve information              a running LinuxSampler instance and to retrieve information
# Line 528  Intellectual Property and Copyright Stat Line 566  Intellectual Property and Copyright Stat
566              via MIDI System Exclusive Messages.              via MIDI System Exclusive Messages.
567  </p>  </p>
568  <a name="anchor4"></a><br /><hr />  <a name="anchor4"></a><br /><hr />
569  <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>
570  <a name="rfc.section.5"></a><h3>5.&nbsp;Communication Overview</h3>  <a name="rfc.section.5"></a><h3>5.&nbsp;
571    Communication Overview</h3>
572    
573  <p>There are two distinct methods of communication between a  <p>There are two distinct methods of communication between a
574              running instance of LinuxSampler and one or more control              running instance of LinuxSampler and one or more control
# Line 543  Intellectual Property and Copyright Stat Line 582  Intellectual Property and Copyright Stat
582              methods will be described next.              methods will be described next.
583  </p>  </p>
584  <a name="anchor5"></a><br /><hr />  <a name="anchor5"></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.1"></a><h3>5.1.&nbsp;Request/response communication method</h3>  <a name="rfc.section.5.1"></a><h3>5.1.&nbsp;
587    Request/response communication method</h3>
588    
589  <p>This simple communication method is based on  <p>This simple communication method is based on
590                  <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
591                  front-end application establishes a TCP connection to the                  front-end application establishes a TCP connection to the
592                  LinuxSampler instance on a certain host system. Then the                  LinuxSampler instance on a certain host system. Then the
593                  front-end application will send certain ASCII based commands                  front-end application will send certain ASCII based commands
# Line 588  Intellectual Property and Copyright Stat Line 628  Intellectual Property and Copyright Stat
628                  MUST be sent back in the same order.                  MUST be sent back in the same order.
629  </p>  </p>
630  <a name="anchor6"></a><br /><hr />  <a name="anchor6"></a><br /><hr />
631  <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>
632  <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;
633    Result format</h3>
634    
635  <p>Result set could be one of the following types:  <p>Result set could be one of the following types:
636  </p>  </p>
# Line 780  Intellectual Property and Copyright Stat Line 821  Intellectual Property and Copyright Stat
821                                            
822  </p>  </p>
823  <a name="anchor7"></a><br /><hr />  <a name="anchor7"></a><br /><hr />
824  <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>
825  <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;
826    Subscribe/notify communication method</h3>
827    
828  <p>This more sophisticated communication method is actually  <p>This more sophisticated communication method is actually
829                  only an extension of the simple request/response                  only an extension of the simple request/response
# Line 858  Intellectual Property and Copyright Stat Line 900  Intellectual Property and Copyright Stat
900  </p>  </p>
901  <p>where &lt;event-id&gt; will be replace by the respective  <p>where &lt;event-id&gt; will be replace by the respective
902                  event that client is no longer interested in receiving. For                  event that client is no longer interested in receiving. For
903                  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>.
904  </p>  </p>
905  <p>Example: the fill states of disk stream buffers have  <p>Example: the fill states of disk stream buffers have
906                  changed on sampler channel 4 and the LinuxSampler instance                  changed on sampler channel 4 and the LinuxSampler instance
# Line 904  Intellectual Property and Copyright Stat Line 946  Intellectual Property and Copyright Stat
946                  it wants to receive.                  it wants to receive.
947  </p>  </p>
948  <a name="control_commands"></a><br /><hr />  <a name="control_commands"></a><br /><hr />
949  <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>
950  <a name="rfc.section.6"></a><h3>6.&nbsp;Description for control commands</h3>  <a name="rfc.section.6"></a><h3>6.&nbsp;
951    Description for control commands</h3>
952    
953  <p>This chapter will describe the available control commands  <p>This chapter will describe the available control commands
954              that can be sent on the TCP connection in detail. Some certain              that can be sent on the TCP connection in detail. Some certain
955              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>
956              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
957              multiple-line responses. In this case LinuxSampler signals the              multiple-line responses. In this case LinuxSampler signals the
958              end of the response by a "." (single dot) line.              end of the response by a "." (single dot) line.
959  </p>  </p>
960  <a name="anchor8"></a><br /><hr />  <a name="anchor8"></a><br /><hr />
961  <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>
962  <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;
963    Ignored lines and comments</h3>
964    
965  <p>White lines, that is lines which only contain space and  <p>White lines, that is lines which only contain space and
966                  tabulator characters, and lines that start with a "#"                  tabulator characters, and lines that start with a "#"
# Line 925  Intellectual Property and Copyright Stat Line 969  Intellectual Property and Copyright Stat
969                  file.                  file.
970  </p>  </p>
971  <a name="anchor9"></a><br /><hr />  <a name="anchor9"></a><br /><hr />
972  <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>
973  <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;
974    Configuring audio drivers</h3>
975    
976  <p>Instances of drivers in LinuxSampler are called devices.  <p>Instances of drivers in LinuxSampler are called devices.
977                  You can use multiple audio devices simultaneously, e.g. to                  You can use multiple audio devices simultaneously, e.g. to
# Line 960  Intellectual Property and Copyright Stat Line 1005  Intellectual Property and Copyright Stat
1005                  possible values, etc.                  possible values, etc.
1006  </p>  </p>
1007  <a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />  <a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
1008  <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>
1009  <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;
1010    Getting amount of available audio output drivers</h3>
1011    
1012  <p>Use the following command to get the number of  <p>Use the following command to get the number of
1013                      audio output drivers currently available for the                      audio output drivers currently available for the
# Line 999  Intellectual Property and Copyright Stat Line 1045  Intellectual Property and Copyright Stat
1045                                            
1046  </p>  </p>
1047  <a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />  <a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
1048  <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>
1049  <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;
1050    Getting all available audio output drivers</h3>
1051    
1052  <p>Use the following command to list all audio output  <p>Use the following command to list all audio output
1053                      drivers currently available for the LinuxSampler                      drivers currently available for the LinuxSampler
# Line 1039  Intellectual Property and Copyright Stat Line 1086  Intellectual Property and Copyright Stat
1086                                            
1087  </p>  </p>
1088  <a name="GET AUDIO_OUTPUT_DRIVER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DRIVER INFO"></a><br /><hr />
1089  <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>
1090  <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;
1091    Getting information about a specific audio
1092                  output driver</h3>                  output driver</h3>
1093    
1094  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
# Line 1057  Intellectual Property and Copyright Stat Line 1105  Intellectual Property and Copyright Stat
1105  </p>  </p>
1106  <p>Where &lt;audio-output-driver&gt; is the name of the  <p>Where &lt;audio-output-driver&gt; is the name of the
1107                      audio output driver, returned by the                      audio output driver, returned by the
1108                      <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.
1109  </p>  </p>
1110  <p>Possible Answers:  <p>Possible Answers:
1111  </p>  </p>
# Line 1138  Intellectual Property and Copyright Stat Line 1186  Intellectual Property and Copyright Stat
1186                                            
1187  </p>  </p>
1188  <a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
1189  <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>
1190  <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;
1191    Getting information about specific audio
1192                  output driver parameter</h3>                  output driver parameter</h3>
1193    
1194  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
# Line 1154  Intellectual Property and Copyright Stat Line 1203  Intellectual Property and Copyright Stat
1203                                            
1204  </p>  </p>
1205  <p>Where &lt;audio&gt; is the name of the audio output  <p>Where &lt;audio&gt; is the name of the audio output
1206                      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,
1207                      &lt;prm&gt; a specific parameter name for which information should be                      &lt;prm&gt; a specific parameter name for which information should be
1208                      obtained (as returned by the                      obtained (as returned by the
1209                      <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
1210                      &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
1211                      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
1212                      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 1214  Intellectual Property and Copyright Stat Line 1263  Intellectual Property and Copyright Stat
1263  <blockquote class="text">  <blockquote class="text">
1264  <p>either true or false, defines if this parameter must be  <p>either true or false, defines if this parameter must be
1265                                  given when the device is to be created with the                                  given when the device is to be created with the
1266                                  <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>
1267                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1268  </p>  </p>
1269  </blockquote>  </blockquote>
# Line 1225  Intellectual Property and Copyright Stat Line 1274  Intellectual Property and Copyright Stat
1274  <blockquote class="text">  <blockquote class="text">
1275  <p>either true or false, if false then this parameter can  <p>either true or false, if false then this parameter can
1276                                  be changed at any time, once the device is created by                                  be changed at any time, once the device is created by
1277                                  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>
1278                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1279  </p>  </p>
1280  </blockquote>  </blockquote>
# Line 1264  Intellectual Property and Copyright Stat Line 1313  Intellectual Property and Copyright Stat
1313  <blockquote class="text">  <blockquote class="text">
1314  <p>reflects the default value for this parameter which is  <p>reflects the default value for this parameter which is
1315                                  used when the device is created and not explicitly                                  used when the device is created and not explicitly
1316                                  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,
1317                                  in case of MULTIPLCITY=true, this is a comma separated                                  in case of MULTIPLCITY=true, this is a comma separated
1318                                  list, that's why character strings are encapsulated into                                  list, that's why character strings are encapsulated into
1319                                  apostrophes (')                                  apostrophes (')
# Line 1392  Intellectual Property and Copyright Stat Line 1441  Intellectual Property and Copyright Stat
1441                                            
1442  </p>  </p>
1443  <a name="CREATE AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="CREATE AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1444  <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>
1445  <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;
1446    Creating an audio output device</h3>
1447    
1448  <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:
1449  </p>  </p>
# Line 1407  Intellectual Property and Copyright Stat Line 1457  Intellectual Property and Copyright Stat
1457  </p>  </p>
1458  <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
1459                      output system as returned by the                      output system as returned by the
1460                      <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>
1461                      command and &lt;param-list&gt; by an optional list of driver                      command and &lt;param-list&gt; by an optional list of driver
1462                      specific parameters in form of "key1=val1 key2=val2 ...", where                      specific parameters in form of "key1=val1 key2=val2 ...", where
1463                      character string values should be encapsulated into apostrophes (').                      character string values should be encapsulated into apostrophes (').
# Line 1476  Intellectual Property and Copyright Stat Line 1526  Intellectual Property and Copyright Stat
1526                                            
1527  </p>  </p>
1528  <a name="DESTROY AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="DESTROY AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1529  <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>
1530  <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;
1531    Destroying an audio output device</h3>
1532    
1533  <p>Use the following command to destroy a created output device:  <p>Use the following command to destroy a created output device:
1534  </p>  </p>
# Line 1491  Intellectual Property and Copyright Stat Line 1542  Intellectual Property and Copyright Stat
1542  </p>  </p>
1543  <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
1544                      audio output device as given by the                      audio output device as given by the
1545                      <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>
1546                      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>
1547                      command.                      command.
1548  </p>  </p>
1549  <p>Possible Answers:  <p>Possible Answers:
# Line 1545  Intellectual Property and Copyright Stat Line 1596  Intellectual Property and Copyright Stat
1596                                            
1597  </p>  </p>
1598  <a name="GET AUDIO_OUTPUT_DEVICES"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1599  <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>
1600  <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;
1601    Getting all created audio output device count</h3>
1602    
1603  <p>Use the following command to count all created audio output devices:  <p>Use the following command to count all created audio output devices:
1604  </p>  </p>
# Line 1582  Intellectual Property and Copyright Stat Line 1634  Intellectual Property and Copyright Stat
1634                                            
1635  </p>  </p>
1636  <a name="LIST AUDIO_OUTPUT_DEVICES"></a><br /><hr />  <a name="LIST AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1637  <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>
1638  <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;
1639    Getting all created audio output device list</h3>
1640    
1641  <p>Use the following command to list all created audio output devices:  <p>Use the following command to list all created audio output devices:
1642  </p>  </p>
# Line 1619  Intellectual Property and Copyright Stat Line 1672  Intellectual Property and Copyright Stat
1672                                            
1673  </p>  </p>
1674  <a name="GET AUDIO_OUTPUT_DEVICE INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DEVICE INFO"></a><br /><hr />
1675  <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>
1676  <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;
1677    Getting current settings of an audio output device</h3>
1678    
1679  <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:
1680  </p>  </p>
# Line 1634  Intellectual Property and Copyright Stat Line 1688  Intellectual Property and Copyright Stat
1688  </p>  </p>
1689  <p>Where &lt;device-id&gt; should be replaced by numerical ID  <p>Where &lt;device-id&gt; should be replaced by numerical ID
1690                      of the audio output device as e.g. returned by the                      of the audio output device as e.g. returned by the
1691                      <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.
1692  </p>  </p>
1693  <p>Possible Answers:  <p>Possible Answers:
1694  </p>  </p>
# Line 1654  Intellectual Property and Copyright Stat Line 1708  Intellectual Property and Copyright Stat
1708  <blockquote class="text">  <blockquote class="text">
1709  <p>identifier of the used audio output driver, as also  <p>identifier of the used audio output driver, as also
1710                                      returned by the                                      returned by the
1711                                      <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>
1712                                      command                                      command
1713  </p>  </p>
1714  </blockquote>  </blockquote>
# Line 1695  Intellectual Property and Copyright Stat Line 1749  Intellectual Property and Copyright Stat
1749                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
1750                      returned by all audio output devices. Every audio output driver                      returned by all audio output devices. Every audio output driver
1751                      might have its own, additional driver specific parameters (see                      might have its own, additional driver specific parameters (see
1752                      <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>)
1753                      which are also returned by this command.                      which are also returned by this command.
1754  </p>  </p>
1755  <p>Example:  <p>Example:
# Line 1725  Intellectual Property and Copyright Stat Line 1779  Intellectual Property and Copyright Stat
1779                                            
1780  </p>  </p>
1781  <a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER"></a><br /><hr />  <a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER"></a><br /><hr />
1782  <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>
1783  <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;
1784    Changing settings of audio output devices</h3>
1785    
1786  <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:
1787  </p>  </p>
# Line 1740  Intellectual Property and Copyright Stat Line 1795  Intellectual Property and Copyright Stat
1795  </p>  </p>
1796  <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
1797                      audio output device as given by the                      audio output device as given by the
1798                      <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>
1799                      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>
1800                      command, &lt;key&gt; by the name of the parameter to change                      command, &lt;key&gt; by the name of the parameter to change
1801                      and &lt;value&gt; by the new value for this parameter.                      and &lt;value&gt; by the new value for this parameter.
1802  </p>  </p>
# Line 1793  Intellectual Property and Copyright Stat Line 1848  Intellectual Property and Copyright Stat
1848                                            
1849  </p>  </p>
1850  <a name="GET AUDIO_OUTPUT_CHANNEL INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_CHANNEL INFO"></a><br /><hr />
1851  <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>
1852  <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;
1853    Getting information about an audio channel</h3>
1854    
1855  <p>Use the following command to get information about an audio channel:  <p>Use the following command to get information about an audio channel:
1856  </p>  </p>
# Line 1807  Intellectual Property and Copyright Stat Line 1863  Intellectual Property and Copyright Stat
1863                                            
1864  </p>  </p>
1865  <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
1866                      <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>
1867                      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>
1868                      command and &lt;audio-chan&gt; the audio channel number.                      command and &lt;audio-chan&gt; the audio channel number.
1869  </p>  </p>
1870  <p>Possible Answers:  <p>Possible Answers:
# Line 1935  Intellectual Property and Copyright Stat Line 1991  Intellectual Property and Copyright Stat
1991                                            
1992  </p>  </p>
1993  <a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO"></a><br /><hr />
1994  <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>
1995  <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;
1996    Getting information about specific audio channel parameter</h3>
1997    
1998  <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:
1999  </p>  </p>
# Line 1949  Intellectual Property and Copyright Stat Line 2006  Intellectual Property and Copyright Stat
2006                                            
2007  </p>  </p>
2008  <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
2009                      <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>
2010                      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>
2011                      command, &lt;chan&gt; the audio channel number                      command, &lt;chan&gt; the audio channel number
2012                      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
2013                      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).
2014  </p>  </p>
2015  <p>Possible Answers:  <p>Possible Answers:
2016  </p>  </p>
# Line 2081  Intellectual Property and Copyright Stat Line 2138  Intellectual Property and Copyright Stat
2138                                            
2139  </p>  </p>
2140  <a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER"></a><br /><hr />  <a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER"></a><br /><hr />
2141  <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>
2142  <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;
2143    Changing settings of audio output channels</h3>
2144    
2145  <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:
2146  </p>  </p>
# Line 2095  Intellectual Property and Copyright Stat Line 2153  Intellectual Property and Copyright Stat
2153                                            
2154  </p>  </p>
2155  <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
2156                      <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>
2157                      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>
2158                      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
2159                      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.
2160  </p>  </p>
# Line 2158  Intellectual Property and Copyright Stat Line 2216  Intellectual Property and Copyright Stat
2216                                            
2217  </p>  </p>
2218  <a name="anchor10"></a><br /><hr />  <a name="anchor10"></a><br /><hr />
2219  <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>
2220  <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;
2221    Configuring MIDI input drivers</h3>
2222    
2223  <p>Instances of drivers in LinuxSampler are called devices. You can use  <p>Instances of drivers in LinuxSampler are called devices. You can use
2224                  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 2188  Intellectual Property and Copyright Stat Line 2247  Intellectual Property and Copyright Stat
2247                  possible values, etc.                  possible values, etc.
2248  </p>  </p>
2249  <a name="GET AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />  <a name="GET AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2250  <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>
2251  <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;
2252    Getting amount of available MIDI input drivers</h3>
2253    
2254  <p>Use the following command to get the number of  <p>Use the following command to get the number of
2255                      MIDI input drivers currently available for the                      MIDI input drivers currently available for the
# Line 2227  Intellectual Property and Copyright Stat Line 2287  Intellectual Property and Copyright Stat
2287                                            
2288  </p>  </p>
2289  <a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />  <a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2290  <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>
2291  <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;
2292    Getting all available MIDI input drivers</h3>
2293    
2294  <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
2295                      for the LinuxSampler instance:                      for the LinuxSampler instance:
# Line 2265  Intellectual Property and Copyright Stat Line 2326  Intellectual Property and Copyright Stat
2326                                            
2327  </p>  </p>
2328  <a name="GET MIDI_INPUT_DRIVER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DRIVER INFO"></a><br /><hr />
2329  <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>
2330  <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;
2331    Getting information about a specific MIDI input driver</h3>
2332    
2333  <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:
2334  </p>  </p>
# Line 2279  Intellectual Property and Copyright Stat Line 2341  Intellectual Property and Copyright Stat
2341                                            
2342  </p>  </p>
2343  <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
2344                      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.
2345  </p>  </p>
2346  <p>Possible Answers:  <p>Possible Answers:
2347  </p>  </p>
# Line 2346  Intellectual Property and Copyright Stat Line 2408  Intellectual Property and Copyright Stat
2408                                            
2409  </p>  </p>
2410  <a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
2411  <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>
2412  <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;
2413    Getting information about specific MIDI input driver parameter</h3>
2414    
2415  <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:
2416  </p>  </p>
# Line 2360  Intellectual Property and Copyright Stat Line 2423  Intellectual Property and Copyright Stat
2423                                            
2424  </p>  </p>
2425  <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
2426                      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
2427                      parameter name for which information should be obtained (as returned by the                      parameter name for which information should be obtained (as returned by the
2428                      <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
2429                      of parameters on which the sought parameter &lt;param&gt; depends on,                      of parameters on which the sought parameter &lt;param&gt; depends on,
2430                      &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 ...",
2431                      where character string values are encapsulated into apostrophes ('). Arguments                      where character string values are encapsulated into apostrophes ('). Arguments
# Line 2409  Intellectual Property and Copyright Stat Line 2472  Intellectual Property and Copyright Stat
2472  <blockquote class="text">  <blockquote class="text">
2473  <p>either true or false, defines if this parameter must be  <p>either true or false, defines if this parameter must be
2474                                  given when the device is to be created with the                                  given when the device is to be created with the
2475                                  <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
2476                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2477  </p>  </p>
2478  </blockquote>  </blockquote>
# Line 2420  Intellectual Property and Copyright Stat Line 2483  Intellectual Property and Copyright Stat
2483  <blockquote class="text">  <blockquote class="text">
2484  <p>either true or false, if false then this parameter can  <p>either true or false, if false then this parameter can
2485                                  be changed at any time, once the device is created by                                  be changed at any time, once the device is created by
2486                                  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
2487                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2488  </p>  </p>
2489  </blockquote>  </blockquote>
# Line 2459  Intellectual Property and Copyright Stat Line 2522  Intellectual Property and Copyright Stat
2522  <blockquote class="text">  <blockquote class="text">
2523  <p>reflects the default value for this parameter which is  <p>reflects the default value for this parameter which is
2524                                  used when the device is created and not explicitly                                  used when the device is created and not explicitly
2525                                  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,
2526                                  in case of MULTIPLCITY=true, this is a comma separated                                  in case of MULTIPLCITY=true, this is a comma separated
2527                                  list, that's why character strings are encapsulated into                                  list, that's why character strings are encapsulated into
2528                                  apostrophes (')                                  apostrophes (')
# Line 2533  Intellectual Property and Copyright Stat Line 2596  Intellectual Property and Copyright Stat
2596                                            
2597  </p>  </p>
2598  <a name="CREATE MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="CREATE MIDI_INPUT_DEVICE"></a><br /><hr />
2599  <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>
2600  <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;
2601    Creating a MIDI input device</h3>
2602    
2603  <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:
2604  </p>  </p>
# Line 2547  Intellectual Property and Copyright Stat Line 2611  Intellectual Property and Copyright Stat
2611                                            
2612  </p>  </p>
2613  <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
2614                      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
2615                      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
2616                      character string values should be encapsulated into apostrophes (').                      character string values should be encapsulated into apostrophes (').
2617                      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 2603  Intellectual Property and Copyright Stat Line 2667  Intellectual Property and Copyright Stat
2667                                            
2668  </p>  </p>
2669  <a name="DESTROY MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="DESTROY MIDI_INPUT_DEVICE"></a><br /><hr />
2670  <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>
2671  <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;
2672    Destroying a MIDI input device</h3>
2673    
2674  <p>Use the following command to destroy a created MIDI input device:  <p>Use the following command to destroy a created MIDI input device:
2675  </p>  </p>
# Line 2617  Intellectual Property and Copyright Stat Line 2682  Intellectual Property and Copyright Stat
2682                                            
2683  </p>  </p>
2684  <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
2685                      <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>
2686                      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>
2687                      command.                      command.
2688  </p>  </p>
2689  <p>Possible Answers:  <p>Possible Answers:
# Line 2668  Intellectual Property and Copyright Stat Line 2733  Intellectual Property and Copyright Stat
2733                                            
2734  </p>  </p>
2735  <a name="GET MIDI_INPUT_DEVICES"></a><br /><hr />  <a name="GET MIDI_INPUT_DEVICES"></a><br /><hr />
2736  <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>
2737  <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;
2738    Getting all created MIDI input device count</h3>
2739    
2740  <p>Use the following command to count all created MIDI input devices:  <p>Use the following command to count all created MIDI input devices:
2741  </p>  </p>
# Line 2705  Intellectual Property and Copyright Stat Line 2771  Intellectual Property and Copyright Stat
2771                                            
2772  </p>  </p>
2773  <a name="LIST MIDI_INPUT_DEVICES"></a><br /><hr />  <a name="LIST MIDI_INPUT_DEVICES"></a><br /><hr />
2774  <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>
2775  <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;
2776    Getting all created MIDI input device list</h3>
2777    
2778  <p>Use the following command to list all created MIDI input devices:  <p>Use the following command to list all created MIDI input devices:
2779  </p>  </p>
# Line 2752  Intellectual Property and Copyright Stat Line 2819  Intellectual Property and Copyright Stat
2819                                            
2820  </p>  </p>
2821  <a name="GET MIDI_INPUT_DEVICE INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DEVICE INFO"></a><br /><hr />
2822  <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>
2823  <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;
2824    Getting current settings of a MIDI input device</h3>
2825    
2826  <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:
2827  </p>  </p>
# Line 2766  Intellectual Property and Copyright Stat Line 2834  Intellectual Property and Copyright Stat
2834                                            
2835  </p>  </p>
2836  <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
2837                      <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>
2838                      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>
2839                      command.                      command.
2840  </p>  </p>
2841  <p>Possible Answers:  <p>Possible Answers:
# Line 2790  Intellectual Property and Copyright Stat Line 2858  Intellectual Property and Copyright Stat
2858                                          </p>                                          </p>
2859  <blockquote class="text">  <blockquote class="text">
2860  <p>identifier of the used MIDI input driver, as e.g.  <p>identifier of the used MIDI input driver, as e.g.
2861                                              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>
2862                                              command                                              command
2863  </p>  </p>
2864  </blockquote>  </blockquote>
# Line 2820  Intellectual Property and Copyright Stat Line 2888  Intellectual Property and Copyright Stat
2888                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
2889                      returned by all MIDI input devices. Every MIDI input driver                      returned by all MIDI input devices. Every MIDI input driver
2890                      might have its own, additional driver specific parameters (see                      might have its own, additional driver specific parameters (see
2891                      <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
2892                      by this command.                      by this command.
2893  </p>  </p>
2894  <p>Example:  <p>Example:
# Line 2840  Intellectual Property and Copyright Stat Line 2908  Intellectual Property and Copyright Stat
2908                                            
2909  </p>  </p>
2910  <a name="SET MIDI_INPUT_DEVICE_PARAMETER"></a><br /><hr />  <a name="SET MIDI_INPUT_DEVICE_PARAMETER"></a><br /><hr />
2911  <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>
2912  <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;
2913    Changing settings of MIDI input devices</h3>
2914    
2915  <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:
2916  </p>  </p>
# Line 2855  Intellectual Property and Copyright Stat Line 2924  Intellectual Property and Copyright Stat
2924  </p>  </p>
2925  <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
2926                      MIDI input device as returned by the                      MIDI input device as returned by the
2927                      <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>
2928                      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>
2929                      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
2930                      &lt;value&gt; by the new value for this parameter.                      &lt;value&gt; by the new value for this parameter.
2931  </p>  </p>
# Line 2907  Intellectual Property and Copyright Stat Line 2976  Intellectual Property and Copyright Stat
2976                                            
2977  </p>  </p>
2978  <a name="GET MIDI_INPUT_PORT INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_PORT INFO"></a><br /><hr />
2979  <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>
2980  <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;
2981    Getting information about a MIDI port</h3>
2982    
2983  <p>Use the following command to get information about a MIDI port:  <p>Use the following command to get information about a MIDI port:
2984  </p>  </p>
# Line 2921  Intellectual Property and Copyright Stat Line 2991  Intellectual Property and Copyright Stat
2991                                            
2992  </p>  </p>
2993  <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
2994                      <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>
2995                      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>
2996                      command and &lt;midi-port&gt; the MIDI input port number.                      command and &lt;midi-port&gt; the MIDI input port number.
2997  </p>  </p>
2998  <p>Possible Answers:  <p>Possible Answers:
# Line 2969  Intellectual Property and Copyright Stat Line 3039  Intellectual Property and Copyright Stat
3039                                            
3040  </p>  </p>
3041  <a name="GET MIDI_INPUT_PORT_PARAMETER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_PORT_PARAMETER INFO"></a><br /><hr />
3042  <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>
3043  <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;
3044    Getting information about specific MIDI port parameter</h3>
3045    
3046  <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:
3047  </p>  </p>
# Line 2983  Intellectual Property and Copyright Stat Line 3054  Intellectual Property and Copyright Stat
3054                                            
3055  </p>  </p>
3056  <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
3057                      <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>
3058                      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>
3059                      command, &lt;port&gt; the MIDI port number and                      command, &lt;port&gt; the MIDI port number and
3060                      &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
3061                      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).
3062  </p>  </p>
3063  <p>Possible Answers:  <p>Possible Answers:
3064  </p>  </p>
# Line 3110  Intellectual Property and Copyright Stat Line 3181  Intellectual Property and Copyright Stat
3181                                            
3182  </p>  </p>
3183  <a name="SET MIDI_INPUT_PORT_PARAMETER"></a><br /><hr />  <a name="SET MIDI_INPUT_PORT_PARAMETER"></a><br /><hr />
3184  <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>
3185  <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;
3186    Changing settings of MIDI input ports</h3>
3187    
3188  <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:
3189  </p>  </p>
# Line 3125  Intellectual Property and Copyright Stat Line 3197  Intellectual Property and Copyright Stat
3197  </p>  </p>
3198  <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
3199                      MIDI device as returned by the                      MIDI device as returned by the
3200                      <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>
3201                      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>
3202                      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
3203                      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
3204                      parameter.                      parameter.
# Line 3176  Intellectual Property and Copyright Stat Line 3248  Intellectual Property and Copyright Stat
3248                                            
3249  </p>  </p>
3250  <a name="anchor11"></a><br /><hr />  <a name="anchor11"></a><br /><hr />
3251  <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>
3252  <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;
3253    Configuring sampler channels</h3>
3254    
3255  <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
3256                  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
3257                  MIDI and audio devices.                  MIDI and audio devices.
3258  </p>  </p>
3259  <a name="LOAD INSTRUMENT"></a><br /><hr />  <a name="LOAD INSTRUMENT"></a><br /><hr />
3260  <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>
3261  <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;
3262    Loading an instrument</h3>
3263    
3264  <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:
3265  </p>  </p>
# Line 3207  Intellectual Property and Copyright Stat Line 3281  Intellectual Property and Copyright Stat
3281                      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
3282                      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
3283                      returns immediately and a background process is launched to load the instrument                      returns immediately and a background process is launched to load the instrument
3284                      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>
3285                      command can be used to obtain loading                      command can be used to obtain loading
3286                      progress from INSTRUMENT_STATUS field. LOAD command will perform sanity checks                      progress from INSTRUMENT_STATUS field. LOAD command will perform sanity checks
3287                      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 3261  Intellectual Property and Copyright Stat Line 3335  Intellectual Property and Copyright Stat
3335                                            
3336  </p>  </p>
3337  <a name="LOAD ENGINE"></a><br /><hr />  <a name="LOAD ENGINE"></a><br /><hr />
3338  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
3339  <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;
3340    Loading a sampler engine</h3>
3341    
3342  <p>A sampler engine type can be associated to a specific sampler  <p>A sampler engine type can be associated to a specific sampler
3343                      channel by the following command:                      channel by the following command:
# Line 3276  Intellectual Property and Copyright Stat Line 3351  Intellectual Property and Copyright Stat
3351                                            
3352  </p>  </p>
3353  <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
3354                      <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;
3355                      the sampler channel as returned by the                      the sampler channel as returned by the
3356                      <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
3357                      <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
3358                      the engine type should be assigned to. This command should be issued                      the engine type should be assigned to. This command should be issued
3359                      after adding a new sampler channel and before any other control                      after adding a new sampler channel and before any other control
3360                      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 3335  Intellectual Property and Copyright Stat Line 3410  Intellectual Property and Copyright Stat
3410                                            
3411  </p>  </p>
3412  <a name="GET CHANNELS"></a><br /><hr />  <a name="GET CHANNELS"></a><br /><hr />
3413  <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>
3414  <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;
3415    Getting all created sampler channel count</h3>
3416    
3417  <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
3418                      current amount of sampler channels, the front-end can send the                      current amount of sampler channels, the front-end can send the
# Line 3373  Intellectual Property and Copyright Stat Line 3449  Intellectual Property and Copyright Stat
3449                                            
3450  </p>  </p>
3451  <a name="LIST CHANNELS"></a><br /><hr />  <a name="LIST CHANNELS"></a><br /><hr />
3452  <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>
3453  <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;
3454    Getting all created sampler channel list</h3>
3455    
3456  <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
3457                      current list of sampler channels, the front-end can send the                      current list of sampler channels, the front-end can send the
# Line 3412  Intellectual Property and Copyright Stat Line 3489  Intellectual Property and Copyright Stat
3489                                            
3490  </p>  </p>
3491  <a name="ADD CHANNEL"></a><br /><hr />  <a name="ADD CHANNEL"></a><br /><hr />
3492  <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>
3493  <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;
3494    Adding a new sampler channel</h3>
3495    
3496  <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
3497                      channel list by sending the following command:                      channel list by sending the following command:
# Line 3486  Intellectual Property and Copyright Stat Line 3564  Intellectual Property and Copyright Stat
3564                                            
3565  </p>  </p>
3566  <a name="REMOVE CHANNEL"></a><br /><hr />  <a name="REMOVE CHANNEL"></a><br /><hr />
3567  <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>
3568  <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;
3569    Removing a sampler channel</h3>
3570    
3571  <p>A sampler channel can be removed by sending the following command:  <p>A sampler channel can be removed by sending the following command:
3572  </p>  </p>
# Line 3501  Intellectual Property and Copyright Stat Line 3580  Intellectual Property and Copyright Stat
3580  </p>  </p>
3581  <p>Where &lt;sampler-channel&gt; should be replaced by the  <p>Where &lt;sampler-channel&gt; should be replaced by the
3582                      number of the sampler channel as given by the                      number of the sampler channel as given by the
3583                      <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>
3584                      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>
3585                      command. The channel numbers of all subsequent sampler channels                      command. The channel numbers of all subsequent sampler channels
3586                      remain the same.                      remain the same.
3587  </p>  </p>
# Line 3552  Intellectual Property and Copyright Stat Line 3631  Intellectual Property and Copyright Stat
3631                                            
3632  </p>  </p>
3633  <a name="GET AVAILABLE_ENGINES"></a><br /><hr />  <a name="GET AVAILABLE_ENGINES"></a><br /><hr />
3634  <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>
3635  <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;
3636    Getting amount of available engines</h3>
3637    
3638  <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:
3639  </p>  </p>
# Line 3588  Intellectual Property and Copyright Stat Line 3668  Intellectual Property and Copyright Stat
3668                                            
3669  </p>  </p>
3670  <a name="LIST AVAILABLE_ENGINES"></a><br /><hr />  <a name="LIST AVAILABLE_ENGINES"></a><br /><hr />
3671  <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>
3672  <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;
3673    Getting all available engines</h3>
3674    
3675  <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:
3676  </p>  </p>
# Line 3627  Intellectual Property and Copyright Stat Line 3708  Intellectual Property and Copyright Stat
3708                                            
3709  </p>  </p>
3710  <a name="GET ENGINE INFO"></a><br /><hr />  <a name="GET ENGINE INFO"></a><br /><hr />
3711  <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>
3712  <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;
3713    Getting information about an engine</h3>
3714    
3715  <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
3716                      sending the following command:                      sending the following command:
# Line 3642  Intellectual Property and Copyright Stat Line 3724  Intellectual Property and Copyright Stat
3724                                            
3725  </p>  </p>
3726  <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
3727                      <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.
3728  </p>  </p>
3729  <p>Possible Answers:  <p>Possible Answers:
3730  </p>  </p>
# Line 3699  Intellectual Property and Copyright Stat Line 3781  Intellectual Property and Copyright Stat
3781                                            
3782  </p>  </p>
3783  <a name="GET CHANNEL INFO"></a><br /><hr />  <a name="GET CHANNEL INFO"></a><br /><hr />
3784  <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>
3785  <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;
3786    Getting sampler channel information</h3>
3787    
3788  <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
3789                      by sending the following command:                      by sending the following command:
# Line 3714  Intellectual Property and Copyright Stat Line 3797  Intellectual Property and Copyright Stat
3797                                            
3798  </p>  </p>
3799  <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
3800                      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>
3801                      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.
3802  </p>  </p>
3803  <p>Possible Answers:  <p>Possible Answers:
3804  </p>  </p>
# Line 3870  Intellectual Property and Copyright Stat Line 3953  Intellectual Property and Copyright Stat
3953  </blockquote>  </blockquote>
3954                                                                            
3955    
3956    <p>MIDI_INSTRUMENT_MAP -
3957                                            </p>
3958    <blockquote class="text">
3959    <p>Determines to which MIDI instrument map this sampler
3960                                                channel is assigned to. Read chapter
3961                                                <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>
3962                                                for a list of possible values.
3963    </p>
3964    </blockquote>
3965                                        
3966    
3967  </blockquote>  </blockquote>
3968                                                            
3969    
# Line 3909  Intellectual Property and Copyright Stat Line 4003  Intellectual Property and Copyright Stat
4003  </p>  </p>
4004  <p>&nbsp;&nbsp;&nbsp;"MIDI_INPUT_CHANNEL: 5"  <p>&nbsp;&nbsp;&nbsp;"MIDI_INPUT_CHANNEL: 5"
4005  </p>  </p>
4006    <p>&nbsp;&nbsp;&nbsp;"VOLUME: 1.0"
4007    </p>
4008    <p>&nbsp;&nbsp;&nbsp;"MUTE: false"
4009    </p>
4010    <p>&nbsp;&nbsp;&nbsp;"SOLO: false"
4011    </p>
4012    <p>&nbsp;&nbsp;&nbsp;"MIDI_INSTRUMENT_MAP: NONE"
4013    </p>
4014  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
4015  </p>  </p>
4016  </blockquote><p>  </blockquote><p>
4017                                            
4018  </p>  </p>
4019  <a name="GET CHANNEL VOICE_COUNT"></a><br /><hr />  <a name="GET CHANNEL VOICE_COUNT"></a><br /><hr />
4020  <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>
4021  <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;
4022    Current number of active voices</h3>
4023    
4024  <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
4025                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 3930  Intellectual Property and Copyright Stat Line 4033  Intellectual Property and Copyright Stat
4033                                            
4034  </p>  </p>
4035  <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
4036                      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>
4037                      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.
4038  </p>  </p>
4039  <p>Possible Answers:  <p>Possible Answers:
4040  </p>  </p>
# Line 3955  Intellectual Property and Copyright Stat Line 4058  Intellectual Property and Copyright Stat
4058                                            
4059  </p>  </p>
4060  <a name="GET CHANNEL STREAM_COUNT"></a><br /><hr />  <a name="GET CHANNEL STREAM_COUNT"></a><br /><hr />
4061  <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>
4062  <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;
4063    Current number of active disk streams</h3>
4064    
4065  <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
4066                      on a sampler channel by sending the following command:                      on a sampler channel by sending the following command:
# Line 3970  Intellectual Property and Copyright Stat Line 4074  Intellectual Property and Copyright Stat
4074                                            
4075  </p>  </p>
4076  <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
4077                      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>
4078                      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.
4079  </p>  </p>
4080  <p>Possible Answers:  <p>Possible Answers:
4081  </p>  </p>
# Line 3997  Intellectual Property and Copyright Stat Line 4101  Intellectual Property and Copyright Stat
4101                                            
4102  </p>  </p>
4103  <a name="GET CHANNEL BUFFER_FILL"></a><br /><hr />  <a name="GET CHANNEL BUFFER_FILL"></a><br /><hr />
4104  <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>
4105  <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;
4106    Current fill state of disk stream buffers</h3>
4107    
4108  <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
4109                      on a sampler channel by sending the following command:                      on a sampler channel by sending the following command:
# Line 4023  Intellectual Property and Copyright Stat Line 4128  Intellectual Property and Copyright Stat
4128  </p>  </p>
4129  <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
4130                      sampler channel number the front-end is interested in                      sampler channel number the front-end is interested in
4131                      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>
4132                      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.
4133  </p>  </p>
4134  <p>Possible Answers:  <p>Possible Answers:
4135  </p>  </p>
# Line 4074  Intellectual Property and Copyright Stat Line 4179  Intellectual Property and Copyright Stat
4179                                            
4180  </p>  </p>
4181  <a name="SET CHANNEL AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_DEVICE"></a><br /><hr />
4182  <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>
4183  <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;
4184    Setting audio output device</h3>
4185    
4186  <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
4187                      channel by sending the following command:                      channel by sending the following command:
# Line 4089  Intellectual Property and Copyright Stat Line 4195  Intellectual Property and Copyright Stat
4195                                            
4196  </p>  </p>
4197  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4198                      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>
4199                      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
4200                      &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
4201                      <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>
4202                      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>
4203                      command.                      command.
4204  </p>  </p>
4205  <p>Possible Answers:  <p>Possible Answers:
# Line 4140  Intellectual Property and Copyright Stat Line 4246  Intellectual Property and Copyright Stat
4246  </blockquote><p>  </blockquote><p>
4247                                            
4248  </p>  </p>
4249  <a name="SET CHANNEL AUDIO_OUTPUT_TYP"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_TYPE"></a><br /><hr />
4250  <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>
4251  <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;
4252    Setting audio output type</h3>
4253    
4254  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4255  </p>  </p>
# Line 4205  Intellectual Property and Copyright Stat Line 4312  Intellectual Property and Copyright Stat
4312                                            
4313  </p>  </p>
4314  <a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr />
4315  <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>
4316  <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;
4317    Setting audio output channel</h3>
4318    
4319  <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
4320                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 4220  Intellectual Property and Copyright Stat Line 4328  Intellectual Property and Copyright Stat
4328                                            
4329  </p>  </p>
4330  <p>Where &lt;sampler-chan&gt; is the sampler channel number  <p>Where &lt;sampler-chan&gt; is the sampler channel number
4331                      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>
4332                      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
4333                      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
4334                      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
4335                      output device where &lt;audio-out&gt; should be routed to.                      output device where &lt;audio-out&gt; should be routed to.
# Line 4271  Intellectual Property and Copyright Stat Line 4379  Intellectual Property and Copyright Stat
4379                                            
4380  </p>  </p>
4381  <a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr />
4382  <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>
4383  <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;
4384    Setting MIDI input device</h3>
4385    
4386  <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
4387                      channel by sending the following command:                      channel by sending the following command:
# Line 4286  Intellectual Property and Copyright Stat Line 4395  Intellectual Property and Copyright Stat
4395                                            
4396  </p>  </p>
4397  <p>Where &lt;sampler-channel&gt; is the sampler channel number  <p>Where &lt;sampler-channel&gt; is the sampler channel number
4398                      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>
4399                      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
4400                      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
4401                      <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>
4402                      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.
4403  </p>  </p>
4404  <p>Possible Answers:  <p>Possible Answers:
4405  </p>  </p>
# Line 4337  Intellectual Property and Copyright Stat Line 4446  Intellectual Property and Copyright Stat
4446                                            
4447  </p>  </p>
4448  <a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr />
4449  <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>
4450  <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;
4451    Setting MIDI input type</h3>
4452    
4453  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4454  </p>  </p>
# Line 4401  Intellectual Property and Copyright Stat Line 4511  Intellectual Property and Copyright Stat
4511                                            
4512  </p>  </p>
4513  <a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr />
4514  <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>
4515  <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;
4516    Setting MIDI input port</h3>
4517    
4518  <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
4519                      channel by sending the following command:                      channel by sending the following command:
# Line 4464  Intellectual Property and Copyright Stat Line 4575  Intellectual Property and Copyright Stat
4575                                            
4576  </p>  </p>
4577  <a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr />
4578  <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>
4579  <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;
4580    Setting MIDI input channel</h3>
4581    
4582  <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
4583                      listen to by sending the following command:                      listen to by sending the following command:
# Line 4527  Intellectual Property and Copyright Stat Line 4639  Intellectual Property and Copyright Stat
4639                                            
4640  </p>  </p>
4641  <a name="SET CHANNEL VOLUME"></a><br /><hr />  <a name="SET CHANNEL VOLUME"></a><br /><hr />
4642  <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>
4643  <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;
4644    Setting channel volume</h3>
4645    
4646  <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
4647                      the following command:                      the following command:
# Line 4591  Intellectual Property and Copyright Stat Line 4704  Intellectual Property and Copyright Stat
4704                                            
4705  </p>  </p>
4706  <a name="SET CHANNEL MUTE"></a><br /><hr />  <a name="SET CHANNEL MUTE"></a><br /><hr />
4707  <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>
4708  <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;
4709    Muting a sampler channel</h3>
4710    
4711  <p>The front-end can mute/unmute a specific sampler  <p>The front-end can mute/unmute a specific sampler
4712                      channel by sending the following command:                      channel by sending the following command:
# Line 4606  Intellectual Property and Copyright Stat Line 4720  Intellectual Property and Copyright Stat
4720                                            
4721  </p>  </p>
4722  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4723                      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>
4724                      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
4725                      &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"
4726                      to unmute the channel.                      to unmute the channel.
4727  </p>  </p>
# Line 4656  Intellectual Property and Copyright Stat Line 4770  Intellectual Property and Copyright Stat
4770                                            
4771  </p>  </p>
4772  <a name="SET CHANNEL SOLO"></a><br /><hr />  <a name="SET CHANNEL SOLO"></a><br /><hr />
4773  <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>
4774  <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;
4775    Soloing a sampler channel</h3>
4776    
4777  <p>The front-end can solo/unsolo a specific sampler channel  <p>The front-end can solo/unsolo a specific sampler channel
4778                      by sending the following command:                      by sending the following command:
# Line 4671  Intellectual Property and Copyright Stat Line 4786  Intellectual Property and Copyright Stat
4786                                            
4787  </p>  </p>
4788  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4789                      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>
4790                      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
4791                      &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"
4792                      to unsolo the channel.                      to unsolo the channel.
4793  </p>  </p>
# Line 4720  Intellectual Property and Copyright Stat Line 4835  Intellectual Property and Copyright Stat
4835  </blockquote><p>  </blockquote><p>
4836                                            
4837  </p>  </p>
4838    <a name="SET CHANNEL MIDI_INSTRUMENT_MAP"></a><br /><hr />
4839    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4840    <a name="rfc.section.6.4.24"></a><h3>6.4.24.&nbsp;
4841    Assigning a MIDI instrument map to a sampler channel</h3>
4842    
4843    <p>The front-end can assign a MIDI instrument map to a specific sampler channel
4844                        by sending the following command:
4845    </p>
4846    <p>
4847                            </p>
4848    <blockquote class="text">
4849    <p>SET CHANNEL MIDI_INSTRUMENT_MAP &lt;sampler-channel&gt; &lt;map&gt;
4850    </p>
4851    </blockquote><p>
4852                        
4853    </p>
4854    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4855                        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>
4856                        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
4857                        &lt;map&gt; can have the following possibilites:
4858    </p>
4859    <p>
4860                            </p>
4861    <blockquote class="text">
4862    <p>"NONE" -
4863                                    </p>
4864    <blockquote class="text">
4865    <p>This is the default setting. In this case
4866                                        the sampler channel is not assigned any MIDI
4867                                        instrument map and thus will ignore all MIDI
4868                                        program change messages.
4869    </p>
4870    </blockquote>
4871                                
4872    
4873    <p>"DEFAULT" -
4874                                    </p>
4875    <blockquote class="text">
4876    <p>The sampler channel will always use the
4877                                        default MIDI instrument map to handle MIDI
4878                                        program change messages.
4879    </p>
4880    </blockquote>
4881                                
4882    
4883    <p>numeric ID -
4884                                    </p>
4885    <blockquote class="text">
4886    <p>You can assign a specific MIDI instrument map
4887                                        by replacing &lt;map&gt; with the respective numeric
4888                                        ID of the MIDI instrument map as returned by the
4889                                        <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>
4890                                        command. Once that map will be deleted, the sampler
4891                                        channel would fall back to "NONE".
4892    </p>
4893    </blockquote>
4894                                
4895    
4896    </blockquote><p>
4897                        
4898    </p>
4899    <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>
4900                        for details regarding MIDI instrument mapping.
4901    </p>
4902    <p>Possible Answers:
4903    </p>
4904    <p>
4905                            </p>
4906    <blockquote class="text">
4907    <p>"OK" -
4908                                    </p>
4909    <blockquote class="text">
4910    <p>on success
4911    </p>
4912    </blockquote>
4913                                
4914    
4915    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4916                                    </p>
4917    <blockquote class="text">
4918    <p>in case it failed, providing an appropriate error code and error message
4919    </p>
4920    </blockquote>
4921                                
4922    
4923    </blockquote><p>
4924                        
4925    </p>
4926    <p>Examples:
4927    </p>
4928    <p>
4929                            </p>
4930    <blockquote class="text">
4931    <p>
4932    </p>
4933    </blockquote><p>
4934                        
4935    </p>
4936  <a name="RESET CHANNEL"></a><br /><hr />  <a name="RESET CHANNEL"></a><br /><hr />
4937  <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>
4938  <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;
4939    Resetting a sampler channel</h3>
4940    
4941  <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:
4942  </p>  </p>
# Line 4786  Intellectual Property and Copyright Stat Line 5000  Intellectual Property and Copyright Stat
5000                                            
5001  </p>  </p>
5002  <a name="anchor12"></a><br /><hr />  <a name="anchor12"></a><br /><hr />
5003  <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>
5004  <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;
5005    Controlling connection</h3>
5006    
5007  <p>The following commands are used to control the connection to LinuxSampler.  <p>The following commands are used to control the connection to LinuxSampler.
5008  </p>  </p>
5009  <a name="SUBSCRIBE"></a><br /><hr />  <a name="SUBSCRIBE"></a><br /><hr />
5010  <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>
5011  <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;
5012    Register front-end for receiving event messages</h3>
5013    
5014  <p>The front-end can register itself to the LinuxSampler application to  <p>The front-end can register itself to the LinuxSampler application to
5015                      be informed about noteworthy events by sending this command:                      be informed about noteworthy events by sending this command:
# Line 4855  Intellectual Property and Copyright Stat Line 5071  Intellectual Property and Copyright Stat
5071                                            
5072  </p>  </p>
5073  <a name="UNSUBSCRIBE"></a><br /><hr />  <a name="UNSUBSCRIBE"></a><br /><hr />
5074  <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>
5075  <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;
5076    Unregister front-end for not receiving event messages</h3>
5077    
5078  <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
5079                      messages anymore by sending the following command:                      messages anymore by sending the following command:
# Line 4918  Intellectual Property and Copyright Stat Line 5135  Intellectual Property and Copyright Stat
5135                                            
5136  </p>  </p>
5137  <a name="SET ECHO"></a><br /><hr />  <a name="SET ECHO"></a><br /><hr />
5138  <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>
5139  <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;
5140    Enable or disable echo of commands</h3>
5141    
5142  <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:
5143  </p>  </p>
# Line 4974  Intellectual Property and Copyright Stat Line 5192  Intellectual Property and Copyright Stat
5192                                            
5193  </p>  </p>
5194  <a name="QUIT"></a><br /><hr />  <a name="QUIT"></a><br /><hr />
5195  <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>
5196  <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;
5197    Close client connection</h3>
5198    
5199  <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:
5200  </p>  </p>
# Line 4991  Intellectual Property and Copyright Stat Line 5210  Intellectual Property and Copyright Stat
5210                      LinuxSampler than really useful for a front-end implementation.                      LinuxSampler than really useful for a front-end implementation.
5211  </p>  </p>
5212  <a name="anchor13"></a><br /><hr />  <a name="anchor13"></a><br /><hr />
5213  <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>
5214  <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;
5215    Global commands</h3>
5216    
5217  <p>The following commands have global impact on the sampler.  <p>The following commands have global impact on the sampler.
5218  </p>  </p>
5219  <a name="GET TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="GET TOTAL_VOICE_COUNT"></a><br /><hr />
5220  <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>
5221  <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;
5222    Current number of active voices</h3>
5223    
5224  <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
5225                      the sampler by sending the following command:                      the sampler by sending the following command:
# Line 5023  Intellectual Property and Copyright Stat Line 5244  Intellectual Property and Copyright Stat
5244                                            
5245  </p>  </p>
5246  <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />  <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />
5247  <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>
5248  <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;
5249    Maximum amount of active voices</h3>
5250    
5251  <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
5252                      by sending the following command:                      by sending the following command:
# Line 5049  Intellectual Property and Copyright Stat Line 5271  Intellectual Property and Copyright Stat
5271                                            
5272  </p>  </p>
5273  <a name="RESET"></a><br /><hr />  <a name="RESET"></a><br /><hr />
5274  <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>
5275  <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;
5276    Reset sampler</h3>
5277    
5278  <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:
5279  </p>  </p>
# Line 5089  Intellectual Property and Copyright Stat Line 5312  Intellectual Property and Copyright Stat
5312                                            
5313  </p>  </p>
5314  <a name="GET SERVER INFO"></a><br /><hr />  <a name="GET SERVER INFO"></a><br /><hr />
5315  <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>
5316  <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;
5317    General sampler informations</h3>
5318    
5319  <p>The client can ask for general informations about the LinuxSampler  <p>The client can ask for general informations about the LinuxSampler
5320                         instance by sending the following command:                         instance by sending the following command:
# Line 5138  Intellectual Property and Copyright Stat Line 5362  Intellectual Property and Copyright Stat
5362                                          </p>                                          </p>
5363  <blockquote class="text">  <blockquote class="text">
5364  <p>version of the LSCP specification the sampler  <p>version of the LSCP specification the sampler
5365                                              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)
5366  </p>  </p>
5367  </blockquote>  </blockquote>
5368                                                                            
# Line 5152  Intellectual Property and Copyright Stat Line 5376  Intellectual Property and Copyright Stat
5376  <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.
5377                      Other fields might be added in future.                      Other fields might be added in future.
5378  </p>  </p>
5379  <a name="anchor14"></a><br /><hr />  <a name="MIDI Instrument Mapping"></a><br /><hr />
5380  <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>
5381  <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;MIDI Instrument Mapping</h3>  <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;
5382    MIDI Instrument Mapping</h3>
5383    
5384  <p>The MIDI protocol provides a way to switch between instruments  <p>The MIDI protocol provides a way to switch between instruments
5385                  by sending so called MIDI bank select and MIDI program change                  by sending so called MIDI bank select and MIDI program change
# Line 5162  Intellectual Property and Copyright Stat Line 5387  Intellectual Property and Copyright Stat
5387                  allow to actually map arbitrary MIDI bank select / program change                  allow to actually map arbitrary MIDI bank select / program change
5388                  numbers with real instruments.                  numbers with real instruments.
5389  </p>  </p>
5390  <p>By default, that is when the sampler is launched, this map will  <p>The sampler allows to manage an arbitrary amount of MIDI
5391                  be empty, thus the sampler will simply ignore all program change                  instrument maps which define which instrument to load on
5392                  messages. The front-end has to explicitly add entries to the map                  which MIDI program change message.
5393                  so the sampler knows how to react on a given program change  </p>
5394                  message, that is by switching to the respectively defined engine  <p>By default, that is when the sampler is launched, there is no
5395                  type and loading the respective instrument.                  map, thus the sampler will simply ignore all program change
5396                    messages. The front-end has to explicitly create at least one
5397                    map, add entries to the map and tell the respective sampler
5398                    channel(s) which MIDI instrument map to use, so the sampler
5399                    knows how to react on a given program change message on the
5400                    respective sampler channel, that is by switching to the
5401                    respectively defined engine type and loading the respective
5402                    instrument. See command
5403                    <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>
5404                    for how to assign a MIDI instrument map to a sampler channel.
5405  </p>  </p>
5406  <p>Also note per MIDI specification a bank select message does not  <p>Also note per MIDI specification a bank select message does not
5407                  cause to switch to another instrument. Instead when receiving a                  cause to switch to another instrument. Instead when receiving a
# Line 5176  Intellectual Property and Copyright Stat Line 5410  Intellectual Property and Copyright Stat
5410                  cause the sampler to switch to the respective instrument as                  cause the sampler to switch to the respective instrument as
5411                  reflected by the current MIDI instrument map.                  reflected by the current MIDI instrument map.
5412  </p>  </p>
5413    <a name="ADD MIDI_INSTRUMENT MAP"></a><br /><hr />
5414    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5415    <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;
5416    Create a new MIDI instrument map</h3>
5417    
5418    <p>The front-end can add a new MIDI instrument map by sending
5419                        the following command:
5420    </p>
5421    <p>
5422                            </p>
5423    <blockquote class="text">
5424    <p>ADD MIDI_INSTRUMENT_MAP [&lt;name&gt;]
5425    </p>
5426    </blockquote><p>
5427                        
5428    </p>
5429    <p>Where &lt;name&gt; is an optional argument allowing to
5430                        assign a custom name to the new map. MIDI instrument Map
5431                        names do not have to be unique.
5432    </p>
5433    <p>Possible Answers:
5434    </p>
5435    <p>
5436                            </p>
5437    <blockquote class="text">
5438    <p>"OK[&lt;map&gt;]" -
5439                                    </p>
5440    <blockquote class="text">
5441    <p>in case a new MIDI instrument map could
5442                                        be added, where &lt;map&gt; reflects the
5443                                        unique ID of the newly created MIDI
5444                                        instrument map
5445    </p>
5446    </blockquote>
5447                                
5448    
5449    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5450                                    </p>
5451    <blockquote class="text">
5452    <p>when a new map could not be created, which
5453                                        might never occur in practice
5454    </p>
5455    </blockquote>
5456                                
5457    
5458    </blockquote><p>
5459                        
5460    </p>
5461    <p>Examples:
5462    </p>
5463    <p>
5464                            </p>
5465    <blockquote class="text">
5466    <p>C: "ADD MIDI_INSTRUMENT_MAP 'Standard Map'"
5467    </p>
5468    <p>S: "OK[0]"
5469    </p>
5470    </blockquote><p>
5471                        
5472    </p>
5473    <p>
5474                            </p>
5475    <blockquote class="text">
5476    <p>C: "ADD MIDI_INSTRUMENT_MAP 'Standard Drumkit'"
5477    </p>
5478    <p>S: "OK[1]"
5479    </p>
5480    </blockquote><p>
5481                        
5482    </p>
5483    <p>
5484                            </p>
5485    <blockquote class="text">
5486    <p>C: "ADD MIDI_INSTRUMENT_MAP"
5487    </p>
5488    <p>S: "OK[5]"
5489    </p>
5490    </blockquote><p>
5491                        
5492    </p>
5493    <a name="REMOVE MIDI_INSTRUMENT_MAP"></a><br /><hr />
5494    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5495    <a name="rfc.section.6.7.2"></a><h3>6.7.2.&nbsp;
5496    Delete one particular or all MIDI instrument maps</h3>
5497    
5498    <p>The front-end can delete a particular MIDI instrument map
5499                        by sending the following command:
5500    </p>
5501    <p>
5502                            </p>
5503    <blockquote class="text">
5504    <p>REMOVE MIDI_INSTRUMENT_MAP &lt;map&gt;
5505    </p>
5506    </blockquote><p>
5507                        
5508    </p>
5509    <p>Where &lt;map&gt; reflects the unique ID of the map to delete
5510                        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>
5511                        command.
5512    </p>
5513    <p>The front-end can delete all MIDI instrument maps by
5514                        sending the following command:
5515    </p>
5516    <p>
5517                            </p>
5518    <blockquote class="text">
5519    <p>REMOVE MIDI_INSTRUMENT_MAP ALL
5520    </p>
5521    </blockquote><p>
5522                        
5523    </p>
5524    <p>Possible Answers:
5525    </p>
5526    <p>
5527                            </p>
5528    <blockquote class="text">
5529    <p>"OK" -
5530                                    </p>
5531    <blockquote class="text">
5532    <p>in case the map(s) could be deleted
5533    </p>
5534    </blockquote>
5535                                
5536    
5537    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5538                                    </p>
5539    <blockquote class="text">
5540    <p>when the given map does not exist
5541    </p>
5542    </blockquote>
5543                                
5544    
5545    </blockquote><p>
5546                        
5547    </p>
5548    <p>Examples:
5549    </p>
5550    <p>
5551                            </p>
5552    <blockquote class="text">
5553    <p>C: "REMOVE MIDI_INSTRUMENT_MAP 0"
5554    </p>
5555    <p>S: "OK"
5556    </p>
5557    </blockquote><p>
5558                        
5559    </p>
5560    <p>
5561                            </p>
5562    <blockquote class="text">
5563    <p>C: "REMOVE MIDI_INSTRUMENT_MAP ALL"
5564    </p>
5565    <p>S: "OK"
5566    </p>
5567    </blockquote><p>
5568                        
5569    </p>
5570    <a name="GET MIDI_INSTRUMENT_MAPS"></a><br /><hr />
5571    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5572    <a name="rfc.section.6.7.3"></a><h3>6.7.3.&nbsp;
5573    Get amount of existing MIDI instrument maps</h3>
5574    
5575    <p>The front-end can retrieve the current amount of MIDI
5576                        instrument maps by sending the following command:
5577    </p>
5578    <p>
5579                            </p>
5580    <blockquote class="text">
5581    <p>GET MIDI_INSTRUMENT_MAPS
5582    </p>
5583    </blockquote><p>
5584                        
5585    </p>
5586    <p>Possible Answers:
5587    </p>
5588    <p>
5589                            </p>
5590    <blockquote class="text">
5591    <p>The sampler will answer by returning the current
5592                                number of MIDI instrument maps.
5593    </p>
5594    </blockquote><p>
5595                        
5596    </p>
5597    <p>Example:
5598    </p>
5599    <p>
5600                            </p>
5601    <blockquote class="text">
5602    <p>C: "GET MIDI_INSTRUMENT_MAPS"
5603    </p>
5604    <p>S: "2"
5605    </p>
5606    </blockquote><p>
5607                        
5608    </p>
5609    <a name="LIST MIDI_INSTRUMENT_MAPS"></a><br /><hr />
5610    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5611    <a name="rfc.section.6.7.4"></a><h3>6.7.4.&nbsp;
5612    Getting all created MIDI instrument maps</h3>
5613    
5614    <p>The number of MIDI instrument maps can change on runtime. To get the
5615                        current list of MIDI instrument maps, the front-end can send the
5616                        following command:
5617    </p>
5618    <p>
5619                            </p>
5620    <blockquote class="text">
5621    <p>LIST MIDI_INSTRUMENT_MAPS
5622    </p>
5623    </blockquote><p>
5624                        
5625    </p>
5626    <p>Possible Answers:
5627    </p>
5628    <p>
5629                            </p>
5630    <blockquote class="text">
5631    <p>The sampler will answer by returning a comma separated list
5632                                with all MIDI instrument maps' numerical IDs.
5633    </p>
5634    </blockquote><p>
5635                        
5636    </p>
5637    <p>Example:
5638    </p>
5639    <p>
5640                            </p>
5641    <blockquote class="text">
5642    <p>C: "LIST MIDI_INSTRUMENT_MAPS"
5643    </p>
5644    <p>S: "0,1,5,12"
5645    </p>
5646    </blockquote><p>
5647                        
5648    </p>
5649    <a name="GET MIDI_INSTRUMENT_MAP INFO"></a><br /><hr />
5650    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5651    <a name="rfc.section.6.7.5"></a><h3>6.7.5.&nbsp;
5652    Getting MIDI instrument map information</h3>
5653    
5654    <p>The front-end can ask for the current settings of a MIDI
5655                        instrument map by sending the following command:
5656    </p>
5657    <p>
5658                            </p>
5659    <blockquote class="text">
5660    <p>GET MIDI_INSTRUMENT_MAP INFO &lt;map&gt;
5661    </p>
5662    </blockquote><p>
5663                        
5664    </p>
5665    <p>Where &lt;map&gt; is the numerical ID of the map the
5666                        front-end is interested in as returned by the
5667                        <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>
5668                        command.
5669    </p>
5670    <p>Possible Answers:
5671    </p>
5672    <p>
5673                            </p>
5674    <blockquote class="text">
5675    <p>LinuxSampler will answer by sending a &lt;CRLF&gt; separated list.
5676                                Each answer line begins with the settings category name
5677                                followed by a colon and then a space character &lt;SP&gt; and finally
5678                                the info character string to that setting category. At the
5679                                moment the following categories are defined:
5680    </p>
5681    <p>
5682                                    </p>
5683    <blockquote class="text">
5684    <p>NAME -
5685                                            </p>
5686    <blockquote class="text">
5687    <p>custom name of the given map,
5688                                                which does not have to be unique
5689    </p>
5690    </blockquote>
5691                                        
5692    
5693    </blockquote>
5694                                
5695    
5696    </blockquote><p>
5697                        
5698    </p>
5699    <p>The mentioned fields above don't have to be in particular order.
5700    </p>
5701    <p>Example:
5702    </p>
5703    <p>
5704                            </p>
5705    <blockquote class="text">
5706    <p>C: "GET MIDI_INSTRUMENT_MAP INFO 0"
5707    </p>
5708    <p>S: "NAME: Standard Map"
5709    </p>
5710    <p>&nbsp;&nbsp;&nbsp;"."
5711    </p>
5712    </blockquote><p>
5713                        
5714    </p>
5715    <a name="SET MIDI_INSTRUMENT_MAP NAME"></a><br /><hr />
5716    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5717    <a name="rfc.section.6.7.6"></a><h3>6.7.6.&nbsp;
5718    Renaming a MIDI instrument map</h3>
5719    
5720    <p>The front-end can alter the custom name of a MIDI
5721                        instrument map by sending the following command:
5722    </p>
5723    <p>
5724                            </p>
5725    <blockquote class="text">
5726    <p>SET MIDI_INSTRUMENT_MAP NAME &lt;map&gt; &lt;name&gt;
5727    </p>
5728    </blockquote><p>
5729                        
5730    </p>
5731    <p>Where &lt;map&gt; is the numerical ID of the map and
5732                        &lt;name&gt; the new custom name of the map, which does not
5733                        have to be unique.
5734    </p>
5735    <p>Possible Answers:
5736    </p>
5737    <p>
5738                            </p>
5739    <blockquote class="text">
5740    <p>"OK" -
5741                                    </p>
5742    <blockquote class="text">
5743    <p>on success
5744    </p>
5745    </blockquote>
5746                                
5747    
5748    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5749                                    </p>
5750    <blockquote class="text">
5751    <p>in case the given map does not exist
5752    </p>
5753    </blockquote>
5754                                
5755    
5756    </blockquote><p>
5757                        
5758    </p>
5759    <p>Example:
5760    </p>
5761    <p>
5762                            </p>
5763    <blockquote class="text">
5764    <p>C: "SET MIDI_INSTRUMENT_MAP NAME 0 'Foo instruments'"
5765    </p>
5766    <p>S: "OK"
5767    </p>
5768    </blockquote><p>
5769                        
5770    </p>
5771  <a name="MAP MIDI_INSTRUMENT"></a><br /><hr />  <a name="MAP MIDI_INSTRUMENT"></a><br /><hr />
5772  <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>
5773  <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;Create or replace a MIDI instrument map entry</h3>  <a name="rfc.section.6.7.7"></a><h3>6.7.7.&nbsp;
5774    Create or replace a MIDI instrument map entry</h3>
5775    
5776  <p>The front-end can create a new or replace an existing entry  <p>The front-end can create a new or replace an existing entry
5777                      in the sampler's MIDI instrument map by sending the following                      in a sampler's MIDI instrument map by sending the following
5778                      command:                      command:
5779  </p>  </p>
5780  <p>  <p>
5781                          </p>                          </p>
5782  <blockquote class="text">  <blockquote class="text">
5783  <p>MAP MIDI_INSTRUMENT &lt;midi_bank_msb&gt;  <p>MAP MIDI_INSTRUMENT &lt;map&gt;
5784                              &lt;midi_bank_lsb&gt; &lt;midi_prog&gt; &lt;engine_name&gt;                              &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;
5785                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;
5786                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]
5787  </p>  </p>
5788  </blockquote><p>  </blockquote><p>
5789                                            
5790  </p>  </p>
5791  <p>Where &lt;midi_bank_msb&gt; is an integer value between  <p>Where &lt;map&gt; is the numeric ID of the map to alter,
5792                      0..127 reflecting the MIDI bank select MSB (coarse) index,                      &lt;midi_bank&gt; is an integer value between
5793                      &lt;midi_bank_lsb&gt; an integer value between 0..127 reflecting                      0..16383 reflecting the MIDI bank select index,
5794                      the MIDI bank select LSB (fine) index, &lt;midi_prog&gt; an                      &lt;midi_prog&gt; an
5795                      integer value between 0..127 reflecting the MIDI program change                      integer value between 0..127 reflecting the MIDI program change
5796                      index, &lt;engine_name&gt; a sampler engine name as returned by                      index, &lt;engine_name&gt; a sampler engine name as returned by
5797                      the <a class="info" href="#LIST AVAILABLE_ENGINES">"LIST AVAILABLE_ENGINES"<span> (</span><span class="info">Getting all available engines</span><span>)</span></a>                      the <a class='info' href='#LIST AVAILABLE_ENGINES'>"LIST AVAILABLE_ENGINES"<span> (</span><span class='info'>Getting all available engines</span><span>)</span></a>
5798                      command (not encapsulated into apostrophes), &lt;filename&gt; the name                      command (not encapsulated into apostrophes), &lt;filename&gt; the name
5799                      of the instrument's file to be deployed (encapsulated into apostrophes), &lt;instrument_index&gt; the index (integer value) of the instrument                      of the instrument's file to be deployed (encapsulated into apostrophes),
5800                        &lt;instrument_index&gt; the index (integer value) of the instrument
5801                      within the given file, &lt;volume_value&gt; reflects the master                      within the given file, &lt;volume_value&gt; reflects the master
5802                      volume of the instrument as optionally dotted number (where a                      volume of the instrument as optionally dotted number (where a
5803                      value < 1.0 means attenuation and a value > 1.0 means                      value < 1.0 means attenuation and a value > 1.0 means
# Line 5298  Intellectual Property and Copyright Stat Line 5892  Intellectual Property and Copyright Stat
5892                      individually. Due to this, in case the frontend shows the                      individually. Due to this, in case the frontend shows the
5893                      load modes of entries, the frontend should retrieve the actual                      load modes of entries, the frontend should retrieve the actual
5894                      mode by i.e. sending                      mode by i.e. sending
5895                      <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>                      <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>
5896                      command(s). Finally the OPTIONAL &lt;name&gt; argument allows to                      command(s). Finally the OPTIONAL &lt;name&gt; argument allows to
5897                      set a custom name (encapsulated into apostrophes) for the mapping                      set a custom name (encapsulated into apostrophes) for the mapping
5898                      entry, useful for frontends for displaying an appropriate name for                      entry, useful for frontends for displaying an appropriate name for
5899                      mapped instruments (using                      mapped instruments (using
5900                      <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>).                      <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>).
5901                                            
5902  </p>  </p>
5903  <p>  <p>
# Line 5332  Intellectual Property and Copyright Stat Line 5926  Intellectual Property and Copyright Stat
5926  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5927                                  </p>                                  </p>
5928  <blockquote class="text">  <blockquote class="text">
5929  <p>when the given engine does not exist or a value  <p>when the given map or engine does not exist or a value
5930                                      is out of range                                      is out of range
5931  </p>  </p>
5932  </blockquote>  </blockquote>
# Line 5346  Intellectual Property and Copyright Stat Line 5940  Intellectual Property and Copyright Stat
5940  <p>  <p>
5941                          </p>                          </p>
5942  <blockquote class="text">  <blockquote class="text">
5943  <p>C: "MAP MIDI_INSTRUMENT 3 0 0 gig '/usr/share/Steinway D.gig' 0 0.8 PERSISTENT"  <p>C: "MAP MIDI_INSTRUMENT 0 3 0 gig '/usr/share/Steinway D.gig' 0 0.8 PERSISTENT"
5944  </p>  </p>
5945  <p>S: "OK"  <p>S: "OK"
5946  </p>  </p>
# Line 5356  Intellectual Property and Copyright Stat Line 5950  Intellectual Property and Copyright Stat
5950  <p>  <p>
5951                          </p>                          </p>
5952  <blockquote class="text">  <blockquote class="text">
5953  <p>C: "MAP MIDI_INSTRUMENT 127 4 50 gig '/home/john/foostrings.gig' 7 1.0"  <p>C: "MAP MIDI_INSTRUMENT 0 4 50 gig '/home/john/foostrings.gig' 7 1.0"
5954  </p>  </p>
5955  <p>S: "OK"  <p>S: "OK"
5956  </p>  </p>
# Line 5370  Intellectual Property and Copyright Stat Line 5964  Intellectual Property and Copyright Stat
5964  </p>  </p>
5965  <p>S: "OK"  <p>S: "OK"
5966  </p>  </p>
5967  <p>C: "MAP MIDI_INSTRUMENT 1 0 0 gig '/usr/share/piano.gig' 0 0.25 'Silent Piano'"  <p>C: "MAP MIDI_INSTRUMENT 0 1 0 gig '/usr/share/piano.gig' 0 0.25 'Silent Piano'"
5968  </p>  </p>
5969  <p>S: "OK"  <p>S: "OK"
5970  </p>  </p>
# Line 5380  Intellectual Property and Copyright Stat Line 5974  Intellectual Property and Copyright Stat
5974  <p>  <p>
5975                          </p>                          </p>
5976  <blockquote class="text">  <blockquote class="text">
5977  <p>C: "MAP MIDI_INSTRUMENT 99 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'"  <p>C: "MAP MIDI_INSTRUMENT 1 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'"
5978  </p>  </p>
5979  <p>S: "OK"  <p>S: "OK"
5980  </p>  </p>
# Line 5388  Intellectual Property and Copyright Stat Line 5982  Intellectual Property and Copyright Stat
5982                                            
5983  </p>  </p>
5984  <a name="GET MIDI_INSTRUMENTS"></a><br /><hr />  <a name="GET MIDI_INSTRUMENTS"></a><br /><hr />
5985  <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>
5986  <a name="rfc.section.6.7.2"></a><h3>6.7.2.&nbsp;Getting ammount of MIDI instrument map entries</h3>  <a name="rfc.section.6.7.8"></a><h3>6.7.8.&nbsp;
5987    Getting ammount of MIDI instrument map entries</h3>
5988    
5989  <p>The front-end can query the amount of currently existing MIDI  <p>The front-end can query the amount of currently existing
5990                      instrument map entries by sending the following                      entries in a MIDI instrument map by sending the following
5991                      command:                      command:
5992  </p>  </p>
5993  <p>  <p>
5994                          </p>                          </p>
5995  <blockquote class="text">  <blockquote class="text">
5996  <p>GET MIDI_INSTRUMENTS  <p>GET MIDI_INSTRUMENTS &lt;map&gt;
5997    </p>
5998    </blockquote><p>
5999                        
6000    </p>
6001    <p>The front-end can query the amount of currently existing
6002                        entries in all MIDI instrument maps by sending the following
6003                        command:
6004    </p>
6005    <p>
6006                            </p>
6007    <blockquote class="text">
6008    <p>GET MIDI_INSTRUMENTS ALL
6009  </p>  </p>
6010  </blockquote><p>  </blockquote><p>
6011                                            
# Line 5408  Intellectual Property and Copyright Stat Line 6015  Intellectual Property and Copyright Stat
6015  <p>  <p>
6016                          </p>                          </p>
6017  <blockquote class="text">  <blockquote class="text">
6018  <p>LinuxSampler will answer by sending the current number of  <p>The sampler will answer by sending the current number of
6019                              entries in the sampler's MIDI instrument map.                              entries in the MIDI instrument map(s).
6020  </p>  </p>
6021  </blockquote><p>  </blockquote><p>
6022                                            
# Line 5419  Intellectual Property and Copyright Stat Line 6026  Intellectual Property and Copyright Stat
6026  <p>  <p>
6027                          </p>                          </p>
6028  <blockquote class="text">  <blockquote class="text">
6029  <p>C: "GET MIDI_INSTRUMENTS"  <p>C: "GET MIDI_INSTRUMENTS 0"
6030    </p>
6031    <p>S: "234"
6032    </p>
6033    </blockquote><p>
6034                        
6035    </p>
6036    <p>
6037                            </p>
6038    <blockquote class="text">
6039    <p>C: "GET MIDI_INSTRUMENTS ALL"
6040  </p>  </p>
6041  <p>S: "634"  <p>S: "954"
6042  </p>  </p>
6043  </blockquote><p>  </blockquote><p>
6044                                            
6045  </p>  </p>
6046  <a name="LIST MIDI_INSTRUMENTS"></a><br /><hr />  <a name="LIST MIDI_INSTRUMENTS"></a><br /><hr />
6047  <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>
6048  <a name="rfc.section.6.7.3"></a><h3>6.7.3.&nbsp;Getting indeces of all MIDI instrument map entries</h3>  <a name="rfc.section.6.7.9"></a><h3>6.7.9.&nbsp;
6049    Getting indeces of all entries of a MIDI instrument map</h3>
6050    
6051  <p>The front-end can query a list of all currently existing MIDI  <p>The front-end can query a list of all currently existing
6052                      instrument map entries by sending the following command:                      entries in a certain MIDI instrument map by sending the following
6053                        command:
6054  </p>  </p>
6055  <p>  <p>
6056                          </p>                          </p>
6057  <blockquote class="text">  <blockquote class="text">
6058  <p>LIST MIDI_INSTRUMENTS  <p>LIST MIDI_INSTRUMENTS &lt;map&gt;
6059    </p>
6060    </blockquote><p>
6061                        
6062    </p>
6063    <p>Where &lt;map&gt; is the numeric ID of the MIDI instrument map.
6064    </p>
6065    <p>The front-end can query a list of all currently existing
6066                        entries of all MIDI instrument maps by sending the following
6067                        command:
6068    </p>
6069    <p>
6070                            </p>
6071    <blockquote class="text">
6072    <p>LIST MIDI_INSTRUMENTS ALL
6073  </p>  </p>
6074  </blockquote><p>  </blockquote><p>
6075                                            
# Line 5446  Intellectual Property and Copyright Stat Line 6079  Intellectual Property and Copyright Stat
6079  <p>  <p>
6080                          </p>                          </p>
6081  <blockquote class="text">  <blockquote class="text">
6082  <p>LinuxSampler will answer by sending a comma separated  <p>The sampler will answer by sending a comma separated
6083                              list of MIDI bank MSB (coarse) - MIDI bank LSB (fine) -                              list of map ID - MIDI bank - MIDI program triples, where
6084                              MIDI program triples, where each triple is encapsulated                              each triple is encapsulated into curly braces. The
6085                              into curly braces. The list is returned in one single                              list is returned in one single line. Each triple
6086                              line. Each triple just reflects the key of the respective                              just reflects the key of the respective map entry,
6087                              map entry, thus subsequent                              thus subsequent
6088                              <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>                              <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>
6089                              command(s) are necessary to retrieve detailed informations                              command(s) are necessary to retrieve detailed informations
6090                              about each entry.                              about each entry.
6091  </p>  </p>
# Line 5464  Intellectual Property and Copyright Stat Line 6097  Intellectual Property and Copyright Stat
6097  <p>  <p>
6098                          </p>                          </p>
6099  <blockquote class="text">  <blockquote class="text">
6100  <p>C: "LIST MIDI_INSTRUMENTS"  <p>C: "LIST MIDI_INSTRUMENTS 0"
6101  </p>  </p>
6102  <p>S: "{0,0,0},{0,0,1},{120,0,3},{120,0,4},{23,127,127}"  <p>S: "{0,0,0},{0,0,1},{0,0,3},{0,1,4},{1,127,127}"
6103  </p>  </p>
6104  </blockquote><p>  </blockquote><p>
6105                                            
6106  </p>  </p>
6107  <a name="UNMAP MIDI_INSTRUMENT"></a><br /><hr />  <a name="UNMAP MIDI_INSTRUMENT"></a><br /><hr />
6108  <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>
6109  <a name="rfc.section.6.7.4"></a><h3>6.7.4.&nbsp;Remove an entry from the MIDI instrument map</h3>  <a name="rfc.section.6.7.10"></a><h3>6.7.10.&nbsp;
6110    Remove an entry from the MIDI instrument map</h3>
6111    
6112  <p>The front-end can delete an entry from the MIDI instrument  <p>The front-end can delete an entry from a MIDI instrument
6113                      map by sending the following command:                      map by sending the following command:
6114  </p>  </p>
6115  <p>  <p>
6116                          </p>                          </p>
6117  <blockquote class="text">  <blockquote class="text">
6118  <p>UNMAP MIDI_INSTRUMENT &lt;midi_bank_msb&gt; &lt;midi_bank_lsb&gt; &lt;midi_prog&gt;  <p>UNMAP MIDI_INSTRUMENT &lt;map&gt; &lt;midi_bank&gt; &lt;midi_prog&gt;
6119  </p>  </p>
6120  </blockquote><p>  </blockquote><p>
6121                                            
6122  </p>  </p>
6123  <p>  <p>
6124                      Where &lt;midi_bank_msb&gt; is an integer value between 0..127                      Where &lt;map&gt; is the numeric ID of the MIDI instrument map,
6125                      reflecting the MIDI bank MSB (coarse) value, &lt;midi_bank_lsb&gt;                      &lt;midi_bank&gt; is an integer value between 0..16383
6126                      an integer value between 0..127 reflecting the MIDI bank LSB                      reflecting the MIDI bank value and
6127                      (fine) value and &lt;midi_prog&gt; an integer value between                      &lt;midi_prog&gt; an integer value between
6128                      0..127 reflecting the MIDI program value of the map entrie's key                      0..127 reflecting the MIDI program value of the map's entrie's key
6129                      index triple.                      index triple.
6130                                            
6131  </p>  </p>
# Line 5524  Intellectual Property and Copyright Stat Line 6158  Intellectual Property and Copyright Stat
6158  <p>  <p>
6159                          </p>                          </p>
6160  <blockquote class="text">  <blockquote class="text">
6161  <p>C: "UNMAP MIDI_INSTRUMENT 2 40 127"  <p>C: "UNMAP MIDI_INSTRUMENT 0 2 127"
6162  </p>  </p>
6163  <p>S: "OK"  <p>S: "OK"
6164  </p>  </p>
# Line 5532  Intellectual Property and Copyright Stat Line 6166  Intellectual Property and Copyright Stat
6166                                            
6167  </p>  </p>
6168  <a name="GET MIDI_INSTRUMENT INFO"></a><br /><hr />  <a name="GET MIDI_INSTRUMENT INFO"></a><br /><hr />
6169  <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>
6170  <a name="rfc.section.6.7.5"></a><h3>6.7.5.&nbsp;Get current settings of MIDI instrument map entry</h3>  <a name="rfc.section.6.7.11"></a><h3>6.7.11.&nbsp;
6171    Get current settings of MIDI instrument map entry</h3>
6172    
6173  <p>The front-end can retrieve the current settings of a certain  <p>The front-end can retrieve the current settings of a certain
6174                      instrument map entry by sending the following command:                      instrument map entry by sending the following command:
# Line 5541  Intellectual Property and Copyright Stat Line 6176  Intellectual Property and Copyright Stat
6176  <p>  <p>
6177                          </p>                          </p>
6178  <blockquote class="text">  <blockquote class="text">
6179  <p>GET MIDI_INSTRUMENT INFO &lt;midi_bank_msb&gt; &lt;midi_bank_lsb&gt; &lt;midi_prog&gt;  <p>GET MIDI_INSTRUMENT INFO &lt;map&gt; &lt;midi_bank&gt; &lt;midi_prog&gt;
6180  </p>  </p>
6181  </blockquote><p>  </blockquote><p>
6182                                            
6183  </p>  </p>
6184  <p>  <p>
6185                      Where &lt;midi_bank_msb&gt; is an integer value between 0..127                      Where &lt;map&gt; is the numeric ID of the MIDI instrument map,
6186                      reflecting the MIDI bank MSB (coarse) value, &lt;midi_bank_lsb&gt;                      &lt;midi_bank&gt; is an integer value between 0..16383
6187                      an integer value between 0..127 reflecting the MIDI bank LSB                      reflecting the MIDI bank value, &lt;midi_bank&gt;
6188                      (fine) value and &lt;midi_prog&gt; an integer value between                      and &lt;midi_prog&gt; an integer value between
6189                      0..127 reflecting the MIDI program value of the map entrie's key                      0..127 reflecting the MIDI program value of the map's entrie's key
6190                      index triple.                      index triple.
6191                                            
6192  </p>  </p>
# Line 5574  Intellectual Property and Copyright Stat Line 6209  Intellectual Property and Copyright Stat
6209                                      This name shall be used by frontends for displaying a                                      This name shall be used by frontends for displaying a
6210                                      name for this mapped instrument. It can be set and                                      name for this mapped instrument. It can be set and
6211                                      changed with the                                      changed with the
6212                                      <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>                                      <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>
6213                                      command and does not have to be unique.                                      command and does not have to be unique.
6214  </p>  </p>
6215  </blockquote>  </blockquote>
# Line 5619  Intellectual Property and Copyright Stat Line 6254  Intellectual Property and Copyright Stat
6254                                  </p>                                  </p>
6255  <blockquote class="text">  <blockquote class="text">
6256  <p>Life time of instrument  <p>Life time of instrument
6257                                      (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).                                      (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).
6258  </p>  </p>
6259  </blockquote>  </blockquote>
6260                                                            
# Line 5644  Intellectual Property and Copyright Stat Line 6279  Intellectual Property and Copyright Stat
6279  <p>  <p>
6280                          </p>                          </p>
6281  <blockquote class="text">  <blockquote class="text">
6282  <p>C: "GET MIDI_INSTRUMENT INFO 3 45 120"  <p>C: "GET MIDI_INSTRUMENT INFO 1 45 120"
6283  </p>  </p>
6284  <p>S: "NAME: Drums for Foo Song"  <p>S: "NAME: Drums for Foo Song"
6285  </p>  </p>
# Line 5666  Intellectual Property and Copyright Stat Line 6301  Intellectual Property and Copyright Stat
6301                                            
6302  </p>  </p>
6303  <a name="CLEAR MIDI_INSTRUMENTS"></a><br /><hr />  <a name="CLEAR MIDI_INSTRUMENTS"></a><br /><hr />
6304  <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>
6305  <a name="rfc.section.6.7.6"></a><h3>6.7.6.&nbsp;Clear MIDI instrument map</h3>  <a name="rfc.section.6.7.12"></a><h3>6.7.12.&nbsp;
6306    Clear MIDI instrument map</h3>
6307    
6308  <p>The front-end can clear the whole MIDI instrument map, that  <p>The front-end can clear a whole MIDI instrument map, that
6309                      is delete all entries by sending the following command:                      is delete all its entries by sending the following command:
6310  </p>  </p>
6311  <p>  <p>
6312                          </p>                          </p>
6313  <blockquote class="text">  <blockquote class="text">
6314  <p>CLEAR MIDI_INSTRUMENTS  <p>CLEAR MIDI_INSTRUMENTS &lt;map&gt;
6315  </p>  </p>
6316  </blockquote><p>  </blockquote><p>
6317                                            
6318  </p>  </p>
6319    <p>Where &lt;map&gt; is the numeric ID of the map to clear.
6320    </p>
6321    <p>The front-end can clear all MIDI instrument maps, that
6322                        is delete all entries of all maps by sending the following
6323                        command:
6324    </p>
6325    <p>
6326                            </p>
6327    <blockquote class="text">
6328    <p>CLEAR MIDI_INSTRUMENTS ALL
6329    </p>
6330    </blockquote><p>
6331                        
6332    </p>
6333    <p>The command "CLEAR MIDI_INSTRUMENTS ALL" does not delete the
6334                        maps, only their entries, thus the map's settings like
6335                        custom name will be preservevd.
6336    </p>
6337  <p>Possible Answers:  <p>Possible Answers:
6338  </p>  </p>
6339  <p>  <p>
# Line 5696  Intellectual Property and Copyright Stat Line 6350  Intellectual Property and Copyright Stat
6350  </blockquote><p>  </blockquote><p>
6351                                            
6352  </p>  </p>
6353  <p>Example:  <p>Examples:
6354  </p>  </p>
6355  <p>  <p>
6356                         </p>                         </p>
6357  <blockquote class="text">  <blockquote class="text">
6358  <p>C: "CLEAR MIDI_INSTRUMENTS"  <p>C: "CLEAR MIDI_INSTRUMENTS 0"
6359    </p>
6360    <p>S: "OK"
6361    </p>
6362    </blockquote><p>
6363                        
6364    </p>
6365    <p>
6366                           </p>
6367    <blockquote class="text">
6368    <p>C: "CLEAR MIDI_INSTRUMENTS ALL"
6369  </p>  </p>
6370  <p>S: "OK"  <p>S: "OK"
6371  </p>  </p>
# Line 5709  Intellectual Property and Copyright Stat Line 6373  Intellectual Property and Copyright Stat
6373                                            
6374  </p>  </p>
6375  <a name="command_syntax"></a><br /><hr />  <a name="command_syntax"></a><br /><hr />
6376  <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>
6377  <a name="rfc.section.7"></a><h3>7.&nbsp;Command Syntax</h3>  <a name="rfc.section.7"></a><h3>7.&nbsp;
6378    Command Syntax</h3>
6379    
6380  <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>
6381              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>)
6382              where applicable.              where applicable.
6383                            
6384  </p>  </p>
# Line 5771  Intellectual Property and Copyright Stat Line 6436  Intellectual Property and Copyright Stat
6436  <p>command =  <p>command =
6437          </p>          </p>
6438  <blockquote class="text">  <blockquote class="text">
6439  <p>ADD SP CHANNEL  <p>ADD SP add_instruction
6440                                    
6441  </p>  </p>
6442  <p>/ MAP SP map_instruction  <p>/ MAP SP map_instruction
# Line 5796  Intellectual Property and Copyright Stat Line 6461  Intellectual Property and Copyright Stat
6461                                    
6462  </p>  </p>
6463  <p>/ REMOVE SP remove_instruction  <p>/ REMOVE SP remove_instruction
   
6464                                    
6465  </p>  </p>
6466  <p>/ SET SP set_instruction  <p>/ SET SP set_instruction
# Line 5826  Intellectual Property and Copyright Stat Line 6490  Intellectual Property and Copyright Stat
6490  </blockquote><p>  </blockquote><p>
6491    
6492  </p>  </p>
6493    <p>add_instruction =
6494            </p>
6495    <blockquote class="text">
6496    <p>CHANNEL
6497                    
6498    </p>
6499    <p>/ MIDI_INSTRUMENT_MAP
6500                    
6501    </p>
6502    <p>/ MIDI_INSTRUMENT_MAP SP map_name
6503                    
6504    </p>
6505    </blockquote><p>
6506    
6507    </p>
6508  <p>subscribe_event =  <p>subscribe_event =
6509          </p>          </p>
6510  <blockquote class="text">  <blockquote class="text">
# Line 5883  Intellectual Property and Copyright Stat Line 6562  Intellectual Property and Copyright Stat
6562  <p>map_instruction =  <p>map_instruction =
6563          </p>          </p>
6564  <blockquote class="text">  <blockquote class="text">
6565  <p>MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value  <p>MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value
6566                                    
6567  </p>  </p>
6568  <p>/ MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode  <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
6569                                    
6570  </p>  </p>
6571  <p>/ MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP entry_name  <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
6572                                    
6573  </p>  </p>
6574  <p>/ MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode SP entry_name  <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
6575                                    
6576  </p>  </p>
6577  </blockquote><p>  </blockquote><p>
# Line 5901  Intellectual Property and Copyright Stat Line 6580  Intellectual Property and Copyright Stat
6580  <p>unmap_instruction =  <p>unmap_instruction =
6581          </p>          </p>
6582  <blockquote class="text">  <blockquote class="text">
6583  <p>MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog  <p>MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog
6584                                    
6585  </p>  </p>
6586  </blockquote><p>  </blockquote><p>
# Line 5913  Intellectual Property and Copyright Stat Line 6592  Intellectual Property and Copyright Stat
6592  <p>CHANNEL SP sampler_channel  <p>CHANNEL SP sampler_channel
6593                                    
6594  </p>  </p>
6595    <p>/ MIDI_INSTRUMENT_MAP SP midi_map
6596                    
6597    </p>
6598    <p>/ MIDI_INSTRUMENT_MAP SP ALL
6599                    
6600    </p>
6601  </blockquote><p>  </blockquote><p>
6602    
6603  </p>  </p>
# Line 5997  Intellectual Property and Copyright Stat Line 6682  Intellectual Property and Copyright Stat
6682  <p>/ TOTAL_VOICE_COUNT_MAX  <p>/ TOTAL_VOICE_COUNT_MAX
6683                                    
6684  </p>  </p>
6685  <p>/ MIDI_INSTRUMENTS  <p>/ MIDI_INSTRUMENTS SP midi_map
6686                                    
6687  </p>  </p>
6688  <p>/ MIDI_INSTRUMENT SP INFO SP midi_bank_msb SP midi_bank_lsb SP midi_prog  <p>/ MIDI_INSTRUMENTS SP ALL
6689                    
6690    </p>
6691    <p>/ MIDI_INSTRUMENT SP INFO SP midi_map SP midi_bank SP midi_prog
6692                    
6693    </p>
6694    <p>/ MIDI_INSTRUMENT_MAPS
6695                    
6696    </p>
6697    <p>/ MIDI_INSTRUMENT_MAP SP INFO SP midi_map
6698                                    
6699  </p>  </p>
6700  </blockquote><p>  </blockquote><p>
# Line 6024  Intellectual Property and Copyright Stat Line 6718  Intellectual Property and Copyright Stat
6718  <p>/ CHANNEL SP set_chan_instruction  <p>/ CHANNEL SP set_chan_instruction
6719                                    
6720  </p>  </p>
6721    <p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name
6722                    
6723    </p>
6724  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
6725                                    
6726  </p>  </p>
# Line 6060  Intellectual Property and Copyright Stat Line 6757  Intellectual Property and Copyright Stat
6757  <p>clear_instruction =  <p>clear_instruction =
6758          </p>          </p>
6759  <blockquote class="text">  <blockquote class="text">
6760  <p>MIDI_INSTRUMENTS  <p>MIDI_INSTRUMENTS SP midi_map
6761                    
6762    </p>
6763    <p>/ MIDI_INSTRUMENTS SP ALL
6764                                    
6765  </p>  </p>
6766  </blockquote><p>  </blockquote><p>
# Line 6126  Intellectual Property and Copyright Stat Line 6826  Intellectual Property and Copyright Stat
6826  <p>/ SOLO SP sampler_channel SP boolean  <p>/ SOLO SP sampler_channel SP boolean
6827                                    
6828  </p>  </p>
6829    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP midi_map
6830                    
6831    </p>
6832    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP NONE
6833                    
6834    </p>
6835    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP DEFAULT
6836                    
6837    </p>
6838  </blockquote><p>  </blockquote><p>
6839    
6840  </p>  </p>
# Line 6174  Intellectual Property and Copyright Stat Line 6883  Intellectual Property and Copyright Stat
6883  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS
6884                                    
6885  </p>  </p>
6886  <p>/ MIDI_INSTRUMENTS  <p>/ MIDI_INSTRUMENTS SP midi_map
6887                    
6888    </p>
6889    <p>/ MIDI_INSTRUMENTS SP ALL
6890                    
6891    </p>
6892    <p>/ MIDI_INSTRUMENT_MAPS
6893                                    
6894  </p>  </p>
6895  </blockquote><p>  </blockquote><p>
# Line 6273  Intellectual Property and Copyright Stat Line 6988  Intellectual Property and Copyright Stat
6988  </blockquote><p>  </blockquote><p>
6989    
6990  </p>  </p>
6991  <p>midi_bank_msb =  <p>midi_map =
6992          </p>          </p>
6993  <blockquote class="text">  <blockquote class="text">
6994  <p>number  <p>number
# Line 6282  Intellectual Property and Copyright Stat Line 6997  Intellectual Property and Copyright Stat
6997  </blockquote><p>  </blockquote><p>
6998    
6999  </p>  </p>
7000  <p>midi_bank_lsb =  <p>midi_bank =
7001          </p>          </p>
7002  <blockquote class="text">  <blockquote class="text">
7003  <p>number  <p>number
# Line 6348  Intellectual Property and Copyright Stat Line 7063  Intellectual Property and Copyright Stat
7063  </blockquote><p>  </blockquote><p>
7064    
7065  </p>  </p>
7066    <p>map_name =
7067            </p>
7068    <blockquote class="text">
7069    <p>stringval
7070                    
7071    </p>
7072    </blockquote><p>
7073    
7074    </p>
7075  <p>entry_name =  <p>entry_name =
7076          </p>          </p>
7077  <blockquote class="text">  <blockquote class="text">
# Line 6388  Intellectual Property and Copyright Stat Line 7112  Intellectual Property and Copyright Stat
7112    
7113  </p>  </p>
7114  <a name="events"></a><br /><hr />  <a name="events"></a><br /><hr />
7115  <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>
7116  <a name="rfc.section.8"></a><h3>8.&nbsp;Events</h3>  <a name="rfc.section.8"></a><h3>8.&nbsp;
7117    Events</h3>
7118    
7119  <p>This chapter will describe all currently defined events supported by LinuxSampler.  <p>This chapter will describe all currently defined events supported by LinuxSampler.
7120  </p>  </p>
7121  <a name="SUBSCRIBE CHANNEL"></a><br /><hr />  <a name="SUBSCRIBE CHANNEL"></a><br /><hr />
7122  <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>
7123  <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;
7124    Number of sampler channels changed</h3>
7125    
7126  <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
7127                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 6422  Intellectual Property and Copyright Stat Line 7148  Intellectual Property and Copyright Stat
7148                  of sampler channels.                  of sampler channels.
7149  </p>  </p>
7150  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
7151  <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>
7152  <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;Number of active voices changed</h3>  <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;
7153    Number of active voices changed</h3>
7154    
7155  <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
7156                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 6451  Intellectual Property and Copyright Stat Line 7178  Intellectual Property and Copyright Stat
7178                  active voices on that channel.                  active voices on that channel.
7179  </p>  </p>
7180  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />
7181  <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>
7182  <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;Number of active disk streams changed</h3>  <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;
7183    Number of active disk streams changed</h3>
7184    
7185  <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
7186                  changes by issuing the following command: SUBSCRIBE STREAM_COUNT                  changes by issuing the following command: SUBSCRIBE STREAM_COUNT
# Line 6480  Intellectual Property and Copyright Stat Line 7208  Intellectual Property and Copyright Stat
7208                  active disk streams on that channel.                  active disk streams on that channel.
7209  </p>  </p>
7210  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />
7211  <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>
7212  <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;Disk stream buffer fill state changed</h3>  <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;
7213    Disk stream buffer fill state changed</h3>
7214    
7215  <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
7216                  on the back-end changes by issuing the following command:                  on the back-end changes by issuing the following command:
# Line 6506  Intellectual Property and Copyright Stat Line 7235  Intellectual Property and Copyright Stat
7235  </p>  </p>
7236  <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
7237                  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
7238                  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>
7239                  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.
7240  </p>  </p>
7241  <a name="SUBSCRIBE INFO"></a><br /><hr />  <a name="SUBSCRIBE INFO"></a><br /><hr />
7242  <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>
7243  <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;Channel information changed</h3>  <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;
7244    Channel information changed</h3>
7245    
7246  <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
7247                  back-end by issuing the following command:                  back-end by issuing the following command:
# Line 6542  Intellectual Property and Copyright Stat Line 7272  Intellectual Property and Copyright Stat
7272                  message is sufficient here.                  message is sufficient here.
7273  </p>  </p>
7274  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
7275  <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>
7276  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;Total number of active voices changed</h3>  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;
7277    Total number of active voices changed</h3>
7278    
7279  <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
7280                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 6570  Intellectual Property and Copyright Stat Line 7301  Intellectual Property and Copyright Stat
7301                  all currently active voices.                  all currently active voices.
7302  </p>  </p>
7303  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
7304  <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>
7305  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;Miscellaneous and debugging events</h3>  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
7306    Miscellaneous and debugging events</h3>
7307    
7308  <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
7309                  the server by issuing the following command:                  the server by issuing the following command:
# Line 6598  Intellectual Property and Copyright Stat Line 7330  Intellectual Property and Copyright Stat
7330                  wants to send to the client. Client MAY display this data to the                  wants to send to the client. Client MAY display this data to the
7331                  user AS IS to facilitate debugging.                  user AS IS to facilitate debugging.
7332  </p>  </p>
7333  <a name="anchor15"></a><br /><hr />  <a name="anchor14"></a><br /><hr />
7334  <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>
7335  <a name="rfc.section.9"></a><h3>9.&nbsp;Security Considerations</h3>  <a name="rfc.section.9"></a><h3>9.&nbsp;
7336    Security Considerations</h3>
7337    
7338  <p>As there is so far no method of authentication and authorization  <p>As there is so far no method of authentication and authorization
7339              defined and so not required for a client applications to succeed to              defined and so not required for a client applications to succeed to
7340              connect, running LinuxSampler might be a security risk for the host              connect, running LinuxSampler might be a security risk for the host
7341              system the LinuxSampler instance is running on.              system the LinuxSampler instance is running on.
7342  </p>  </p>
7343  <a name="anchor16"></a><br /><hr />  <a name="anchor15"></a><br /><hr />
7344  <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>
7345  <a name="rfc.section.10"></a><h3>10.&nbsp;Acknowledgments</h3>  <a name="rfc.section.10"></a><h3>10.&nbsp;
7346    Acknowledgments</h3>
7347    
7348  <p>This document has benefited greatly from the comments of the  <p>This document has benefited greatly from the comments of the
7349              following people, discussed on the LinuxSampler developer's mailing              following people, discussed on the LinuxSampler developer's mailing
# Line 6630  Intellectual Property and Copyright Stat Line 7364  Intellectual Property and Copyright Stat
7364                            
7365  </p>  </p>
7366  <a name="rfc.references1"></a><br /><hr />  <a name="rfc.references1"></a><br /><hr />
7367  <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>
7368  <h3>11.&nbsp;References</h3>  <h3>11.&nbsp;References</h3>
7369  <table width="99%" border="0">  <table width="99%" border="0">
7370  <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 6642  Intellectual Property and Copyright Stat Line 7376  Intellectual Property and Copyright Stat
7376  </table>  </table>
7377    
7378  <a name="rfc.authors"></a><br /><hr />  <a name="rfc.authors"></a><br /><hr />
7379  <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>
7380  <h3>Author's Address</h3>  <h3>Author's Address</h3>
7381  <table width="99%" border="0" cellpadding="0" cellspacing="0">  <table width="99%" border="0" cellpadding="0" cellspacing="0">
7382  <tr><td class="author-text">&nbsp;</td>  <tr><td class="author-text">&nbsp;</td>
# Line 6660  Schoenebeck</td></tr> Line 7394  Schoenebeck</td></tr>
7394  <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>
7395  </table>  </table>
7396  <a name="rfc.copyright"></a><br /><hr />  <a name="rfc.copyright"></a><br /><hr />
7397  <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>
7398  <h3>Intellectual Property Statement</h3>  <h3>Full Copyright Statement</h3>
7399  <p class='copyright'>  <p class='copyright'>
7400  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>  
7401  <p class='copyright'>  <p class='copyright'>
7402  The IETF invites any interested party to bring to its  This document is subject to the rights,
7403  attention any copyrights, patents or patent applications, or  licenses and restrictions contained in BCP&nbsp;78,
7404  other proprietary rights which may cover technology that may be  and except as set forth therein,
7405  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>  
7406  <p class='copyright'>  <p class='copyright'>
7407  Copyright &copy; The Internet Society (2006). All Rights Reserved.</p>  This document and the information contained herein are provided
7408    on an &ldquo;AS IS&rdquo; basis and THE CONTRIBUTOR,
7409    THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY),
7410    THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM
7411    ALL WARRANTIES,
7412    EXPRESS OR IMPLIED,
7413    INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
7414    INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
7415    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>
7416    <h3>Intellectual Property</h3>
7417  <p class='copyright'>  <p class='copyright'>
7418  This document and translations of it may be copied and furnished to  The IETF takes no position regarding the validity or scope of any
7419  others, and derivative works that comment on or otherwise explain it  Intellectual Property Rights or other rights that might be claimed
7420  or assist in its implementation may be prepared, copied, published and  to pertain to the implementation or use of the technology
7421  distributed, in whole or in part, without restriction of any kind,  described in this document or the extent to which any license
7422  provided that the above copyright notice and this paragraph are  under such rights might or might not be available; nor does it
7423  included on all such copies and derivative works. However, this  represent that it has made any independent effort to identify any
7424  document itself may not be modified in any way, such as by removing  such rights.
7425  the copyright notice or references to the Internet Society or other  Information on the procedures with respect to
7426  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>  
7427  <p class='copyright'>  <p class='copyright'>
7428  The limited permissions granted above are perpetual and will not be  Copies of IPR disclosures made to the IETF Secretariat and any
7429  revoked by the Internet Society or its successors or assignees.</p>  assurances of licenses to be made available,
7430    or the result of an attempt made to obtain a general license or
7431    permission for the use of such proprietary rights by implementers or
7432    users of this specification can be obtained from the IETF on-line IPR
7433    repository at <a href='http://www.ietf.org/ipr'>http://www.ietf.org/ipr</a>.</p>
7434  <p class='copyright'>  <p class='copyright'>
7435  This document and the information contained herein is provided on an  The IETF invites any interested party to bring to its attention
7436  &ldquo;AS IS&rdquo; basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING  any copyrights,
7437  TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING  patents or patent applications,
7438  BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION  or other
7439  HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF  proprietary rights that may cover technology that may be required
7440  MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>  to implement this standard.
7441    Please address the information to the IETF at <a href='mailto:ietf-ipr@ietf.org'>ietf-ipr@ietf.org</a>.</p>
7442  <h3>Acknowledgment</h3>  <h3>Acknowledgment</h3>
7443  <p class='copyright'>  <p class='copyright'>
7444  Funding for the RFC Editor function is currently provided by the  Funding for the RFC Editor function is provided by
7445  Internet Society.</p>  the IETF Administrative Support Activity (IASA).</p>
7446  </body></html>  </body></html>
Legend:
Removed from v.973  
changed lines
  Added in v.974
  ViewVC Help
Powered by ViewVC