/[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 945 by schoenebeck, Sun Nov 26 16:39:49 2006 UTC revision 1002 by schoenebeck, Wed Dec 27 16:23:46 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 30, 2007</td><td class="header">December 27, 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 30, 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="#CREATE FX_SEND">6.4.25.</a>&nbsp;
322    Adding an effect send to a sampler channel<br />
323    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#DESTROY FX_SEND">6.4.26.</a>&nbsp;
324    Removing an effect send from a sampler channel<br />
325    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FX_SENDS">6.4.27.</a>&nbsp;
326    Getting amount of effect sends on a sampler channel<br />
327    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST FX_SENDS">6.4.28.</a>&nbsp;
328    Listing all effect sends on a sampler channel<br />
329    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FX_SEND INFO">6.4.29.</a>&nbsp;
330    Getting effect send information<br />
331    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND AUDIO_OUTPUT_CHANNEL">6.4.30.</a>&nbsp;
332    Altering effect send's audio routing<br />
333    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.31.</a>&nbsp;
334  Resetting a sampler channel<br />  Resetting a sampler channel<br />
335  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
336  Controlling connection<br />  Controlling connection<br />
# Line 318  Maximum amount of active voices<br /> Line 352  Maximum amount of active voices<br />
352  Reset sampler<br />  Reset sampler<br />
353  &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;
354  General sampler informations<br />  General sampler informations<br />
355  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor14">6.7.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#MIDI Instrument Mapping">6.7.</a>&nbsp;
356  MIDI Instrument Mapping<br />  MIDI Instrument Mapping<br />
357  &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;
358    Create a new MIDI instrument map<br />
359    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#REMOVE MIDI_INSTRUMENT_MAP">6.7.2.</a>&nbsp;
360    Delete one particular or all MIDI instrument maps<br />
361    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENT_MAPS">6.7.3.</a>&nbsp;
362    Get amount of existing MIDI instrument maps<br />
363    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INSTRUMENT_MAPS">6.7.4.</a>&nbsp;
364    Getting all created MIDI instrument maps<br />
365    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENT_MAP INFO">6.7.5.</a>&nbsp;
366    Getting MIDI instrument map information<br />
367    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET MIDI_INSTRUMENT_MAP NAME">6.7.6.</a>&nbsp;
368    Renaming a MIDI instrument map<br />
369    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#MAP MIDI_INSTRUMENT">6.7.7.</a>&nbsp;
370  Create or replace a MIDI instrument map entry<br />  Create or replace a MIDI instrument map entry<br />
371  &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;
372  Getting ammount of MIDI instrument map entries<br />  Getting ammount of MIDI instrument map entries<br />
373  &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;
374  Getting indeces of all MIDI instrument map entries<br />  Getting indeces of all entries of a MIDI instrument map<br />
375  &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;
376  Remove an entry from the MIDI instrument map<br />  Remove an entry from the MIDI instrument map<br />
377  &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;
378  Get current settings of MIDI instrument map entry<br />  Get current settings of MIDI instrument map entry<br />
379  &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;
380  Clear MIDI instrument map<br />  Clear MIDI instrument map<br />
381  <a href="#command_syntax">7.</a>&nbsp;  <a href="#command_syntax">7.</a>&nbsp;
382  Command Syntax<br />  Command Syntax<br />
383  <a href="#events">8.</a>&nbsp;  <a href="#events">8.</a>&nbsp;
384  Events<br />  Events<br />
385  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL">8.1.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT">8.1.</a>&nbsp;
386    Number of audio output devices changed<br />
387    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO">8.2.</a>&nbsp;
388    Audio output device's settings changed<br />
389    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_COUNT">8.3.</a>&nbsp;
390    Number of MIDI input devices changed<br />
391    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_INFO">8.4.</a>&nbsp;
392    MIDI input device's settings changed<br />
393    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a>&nbsp;
394  Number of sampler channels changed<br />  Number of sampler channels changed<br />
395  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.2.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.6.</a>&nbsp;
396  Number of active voices changed<br />  Number of active voices changed<br />
397  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.3.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.7.</a>&nbsp;
398  Number of active disk streams changed<br />  Number of active disk streams changed<br />
399  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.4.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.8.</a>&nbsp;
400  Disk stream buffer fill state changed<br />  Disk stream buffer fill state changed<br />
401  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE INFO">8.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;
402  Channel information changed<br />  Channel information changed<br />
403  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.6.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.10.</a>&nbsp;
404  Total number of active voices changed<br />  Total number of active voices changed<br />
405  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.11.</a>&nbsp;
406    Number of MIDI instrument maps changed<br />
407    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.12.</a>&nbsp;
408    MIDI instrument map information changed<br />
409    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.13.</a>&nbsp;
410    Number of MIDI instruments changed<br />
411    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.14.</a>&nbsp;
412    MIDI instrument information changed<br />
413    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.15.</a>&nbsp;
414  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
415  <a href="#anchor15">9.</a>&nbsp;  <a href="#anchor14">9.</a>&nbsp;
416  Security Considerations<br />  Security Considerations<br />
417  <a href="#anchor16">10.</a>&nbsp;  <a href="#anchor15">10.</a>&nbsp;
418  Acknowledgments<br />  Acknowledgments<br />
419  <a href="#rfc.references1">11.</a>&nbsp;  <a href="#rfc.references1">11.</a>&nbsp;
420  References<br />  References<br />
# Line 364  Intellectual Property and Copyright Stat Line 426  Intellectual Property and Copyright Stat
426  <br clear="all" />  <br clear="all" />
427    
428  <a name="anchor1"></a><br /><hr />  <a name="anchor1"></a><br /><hr />
429  <table summary="layout" 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>
430  <a name="rfc.section.1"></a><h3>1.&nbsp;Requirements notation</h3>  <a name="rfc.section.1"></a><h3>1.&nbsp;
431    Requirements notation</h3>
432    
433  <p>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL",  <p>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL",
434              "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",              "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",
435              and "OPTIONAL" in this document are to be interpreted as              and "OPTIONAL" in this document are to be interpreted as
436              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>.
437  </p>  </p>
438  <p>This protocol is always case-sensitive if not explicitly  <p>This protocol is always case-sensitive if not explicitly
439              claimed the opposite.              claimed the opposite.
# Line 446  Intellectual Property and Copyright Stat Line 509  Intellectual Property and Copyright Stat
509              return and line feed characters respectively.              return and line feed characters respectively.
510  </p>  </p>
511  <a name="LSCP versioning"></a><br /><hr />  <a name="LSCP versioning"></a><br /><hr />
512  <table summary="layout" 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>
513  <a name="rfc.section.2"></a><h3>2.&nbsp;Versioning of this specification</h3>  <a name="rfc.section.2"></a><h3>2.&nbsp;
514    Versioning of this specification</h3>
515    
516  <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
517              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 554  Intellectual Property and Copyright Stat
554  <p>  <p>
555              Compatibility can only be claimed if both rules are true.              Compatibility can only be claimed if both rules are true.
556              The frontend can use the              The frontend can use the
557              <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
558              get the version of the LSCP specification the sampler complies with.              get the version of the LSCP specification the sampler complies with.
559                            
560  </p>  </p>
561  <a name="anchor2"></a><br /><hr />  <a name="anchor2"></a><br /><hr />
562  <table summary="layout" 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>
563  <a name="rfc.section.3"></a><h3>3.&nbsp;Introduction</h3>  <a name="rfc.section.3"></a><h3>3.&nbsp;
564    Introduction</h3>
565    
566  <p>LinuxSampler is a so called software sampler application  <p>LinuxSampler is a so called software sampler application
567              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 581  Intellectual Property and Copyright Stat
581              there.              there.
582  </p>  </p>
583  <a name="anchor3"></a><br /><hr />  <a name="anchor3"></a><br /><hr />
584  <table summary="layout" 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>
585  <a name="rfc.section.4"></a><h3>4.&nbsp;Focus of this protocol</h3>  <a name="rfc.section.4"></a><h3>4.&nbsp;
586    Focus of this protocol</h3>
587    
588  <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
589              a running LinuxSampler instance and to retrieve information              a running LinuxSampler instance and to retrieve information
# Line 528  Intellectual Property and Copyright Stat Line 594  Intellectual Property and Copyright Stat
594              via MIDI System Exclusive Messages.              via MIDI System Exclusive Messages.
595  </p>  </p>
596  <a name="anchor4"></a><br /><hr />  <a name="anchor4"></a><br /><hr />
597  <table summary="layout" 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>
598  <a name="rfc.section.5"></a><h3>5.&nbsp;Communication Overview</h3>  <a name="rfc.section.5"></a><h3>5.&nbsp;
599    Communication Overview</h3>
600    
601  <p>There are two distinct methods of communication between a  <p>There are two distinct methods of communication between a
602              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 610  Intellectual Property and Copyright Stat
610              methods will be described next.              methods will be described next.
611  </p>  </p>
612  <a name="anchor5"></a><br /><hr />  <a name="anchor5"></a><br /><hr />
613  <table summary="layout" 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>
614  <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;
615    Request/response communication method</h3>
616    
617  <p>This simple communication method is based on  <p>This simple communication method is based on
618                  <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
619                  front-end application establishes a TCP connection to the                  front-end application establishes a TCP connection to the
620                  LinuxSampler instance on a certain host system. Then the                  LinuxSampler instance on a certain host system. Then the
621                  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 656  Intellectual Property and Copyright Stat
656                  MUST be sent back in the same order.                  MUST be sent back in the same order.
657  </p>  </p>
658  <a name="anchor6"></a><br /><hr />  <a name="anchor6"></a><br /><hr />
659  <table summary="layout" 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>
660  <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;
661    Result format</h3>
662    
663  <p>Result set could be one of the following types:  <p>Result set could be one of the following types:
664  </p>  </p>
# Line 780  Intellectual Property and Copyright Stat Line 849  Intellectual Property and Copyright Stat
849                                            
850  </p>  </p>
851  <a name="anchor7"></a><br /><hr />  <a name="anchor7"></a><br /><hr />
852  <table summary="layout" 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>
853  <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;
854    Subscribe/notify communication method</h3>
855    
856  <p>This more sophisticated communication method is actually  <p>This more sophisticated communication method is actually
857                  only an extension of the simple request/response                  only an extension of the simple request/response
# Line 858  Intellectual Property and Copyright Stat Line 928  Intellectual Property and Copyright Stat
928  </p>  </p>
929  <p>where &lt;event-id&gt; will be replace by the respective  <p>where &lt;event-id&gt; will be replace by the respective
930                  event that client is no longer interested in receiving. For                  event that client is no longer interested in receiving. For
931                  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>.
932  </p>  </p>
933  <p>Example: the fill states of disk stream buffers have  <p>Example: the fill states of disk stream buffers have
934                  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 974  Intellectual Property and Copyright Stat
974                  it wants to receive.                  it wants to receive.
975  </p>  </p>
976  <a name="control_commands"></a><br /><hr />  <a name="control_commands"></a><br /><hr />
977  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
978  <a name="rfc.section.6"></a><h3>6.&nbsp;Description for control commands</h3>  <a name="rfc.section.6"></a><h3>6.&nbsp;
979    Description for control commands</h3>
980    
981  <p>This chapter will describe the available control commands  <p>This chapter will describe the available control commands
982              that can be sent on the TCP connection in detail. Some certain              that can be sent on the TCP connection in detail. Some certain
983              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>
984              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
985              multiple-line responses. In this case LinuxSampler signals the              multiple-line responses. In this case LinuxSampler signals the
986              end of the response by a "." (single dot) line.              end of the response by a "." (single dot) line.
987  </p>  </p>
988  <a name="anchor8"></a><br /><hr />  <a name="anchor8"></a><br /><hr />
989  <table summary="layout" 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>
990  <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;
991    Ignored lines and comments</h3>
992    
993  <p>White lines, that is lines which only contain space and  <p>White lines, that is lines which only contain space and
994                  tabulator characters, and lines that start with a "#"                  tabulator characters, and lines that start with a "#"
# Line 925  Intellectual Property and Copyright Stat Line 997  Intellectual Property and Copyright Stat
997                  file.                  file.
998  </p>  </p>
999  <a name="anchor9"></a><br /><hr />  <a name="anchor9"></a><br /><hr />
1000  <table summary="layout" 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>
1001  <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;
1002    Configuring audio drivers</h3>
1003    
1004  <p>Instances of drivers in LinuxSampler are called devices.  <p>Instances of drivers in LinuxSampler are called devices.
1005                  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 1033  Intellectual Property and Copyright Stat
1033                  possible values, etc.                  possible values, etc.
1034  </p>  </p>
1035  <a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />  <a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
1036  <table summary="layout" 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>
1037  <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;
1038    Getting amount of available audio output drivers</h3>
1039    
1040  <p>Use the following command to get the number of  <p>Use the following command to get the number of
1041                      audio output drivers currently available for the                      audio output drivers currently available for the
# Line 999  Intellectual Property and Copyright Stat Line 1073  Intellectual Property and Copyright Stat
1073                                            
1074  </p>  </p>
1075  <a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />  <a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
1076  <table summary="layout" 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>
1077  <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;
1078    Getting all available audio output drivers</h3>
1079    
1080  <p>Use the following command to list all audio output  <p>Use the following command to list all audio output
1081                      drivers currently available for the LinuxSampler                      drivers currently available for the LinuxSampler
# Line 1039  Intellectual Property and Copyright Stat Line 1114  Intellectual Property and Copyright Stat
1114                                            
1115  </p>  </p>
1116  <a name="GET AUDIO_OUTPUT_DRIVER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DRIVER INFO"></a><br /><hr />
1117  <table summary="layout" 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>
1118  <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;
1119    Getting information about a specific audio
1120                  output driver</h3>                  output driver</h3>
1121    
1122  <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 1133  Intellectual Property and Copyright Stat
1133  </p>  </p>
1134  <p>Where &lt;audio-output-driver&gt; is the name of the  <p>Where &lt;audio-output-driver&gt; is the name of the
1135                      audio output driver, returned by the                      audio output driver, returned by the
1136                      <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.
1137  </p>  </p>
1138  <p>Possible Answers:  <p>Possible Answers:
1139  </p>  </p>
# Line 1138  Intellectual Property and Copyright Stat Line 1214  Intellectual Property and Copyright Stat
1214                                            
1215  </p>  </p>
1216  <a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
1217  <table summary="layout" 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>
1218  <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;
1219    Getting information about specific audio
1220                  output driver parameter</h3>                  output driver parameter</h3>
1221    
1222  <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 1231  Intellectual Property and Copyright Stat
1231                                            
1232  </p>  </p>
1233  <p>Where &lt;audio&gt; is the name of the audio output  <p>Where &lt;audio&gt; is the name of the audio output
1234                      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,
1235                      &lt;prm&gt; a specific parameter name for which information should be                      &lt;prm&gt; a specific parameter name for which information should be
1236                      obtained (as returned by the                      obtained (as returned by the
1237                      <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
1238                      &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
1239                      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
1240                      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 1291  Intellectual Property and Copyright Stat
1291  <blockquote class="text">  <blockquote class="text">
1292  <p>either true or false, defines if this parameter must be  <p>either true or false, defines if this parameter must be
1293                                  given when the device is to be created with the                                  given when the device is to be created with the
1294                                  <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>
1295                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1296  </p>  </p>
1297  </blockquote>  </blockquote>
# Line 1225  Intellectual Property and Copyright Stat Line 1302  Intellectual Property and Copyright Stat
1302  <blockquote class="text">  <blockquote class="text">
1303  <p>either true or false, if false then this parameter can  <p>either true or false, if false then this parameter can
1304                                  be changed at any time, once the device is created by                                  be changed at any time, once the device is created by
1305                                  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>
1306                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1307  </p>  </p>
1308  </blockquote>  </blockquote>
# Line 1264  Intellectual Property and Copyright Stat Line 1341  Intellectual Property and Copyright Stat
1341  <blockquote class="text">  <blockquote class="text">
1342  <p>reflects the default value for this parameter which is  <p>reflects the default value for this parameter which is
1343                                  used when the device is created and not explicitly                                  used when the device is created and not explicitly
1344                                  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,
1345                                  in case of MULTIPLCITY=true, this is a comma separated                                  in case of MULTIPLCITY=true, this is a comma separated
1346                                  list, that's why character strings are encapsulated into                                  list, that's why character strings are encapsulated into
1347                                  apostrophes (')                                  apostrophes (')
# Line 1392  Intellectual Property and Copyright Stat Line 1469  Intellectual Property and Copyright Stat
1469                                            
1470  </p>  </p>
1471  <a name="CREATE AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="CREATE AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1472  <table summary="layout" 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>
1473  <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;
1474    Creating an audio output device</h3>
1475    
1476  <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:
1477  </p>  </p>
# Line 1407  Intellectual Property and Copyright Stat Line 1485  Intellectual Property and Copyright Stat
1485  </p>  </p>
1486  <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
1487                      output system as returned by the                      output system as returned by the
1488                      <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>
1489                      command and &lt;param-list&gt; by an optional list of driver                      command and &lt;param-list&gt; by an optional list of driver
1490                      specific parameters in form of "key1=val1 key2=val2 ...", where                      specific parameters in form of "key1=val1 key2=val2 ...", where
1491                      character string values should be encapsulated into apostrophes (').                      character string values should be encapsulated into apostrophes (').
# Line 1476  Intellectual Property and Copyright Stat Line 1554  Intellectual Property and Copyright Stat
1554                                            
1555  </p>  </p>
1556  <a name="DESTROY AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="DESTROY AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1557  <table summary="layout" 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>
1558  <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;
1559    Destroying an audio output device</h3>
1560    
1561  <p>Use the following command to destroy a created output device:  <p>Use the following command to destroy a created output device:
1562  </p>  </p>
# Line 1491  Intellectual Property and Copyright Stat Line 1570  Intellectual Property and Copyright Stat
1570  </p>  </p>
1571  <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
1572                      audio output device as given by the                      audio output device as given by the
1573                      <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>
1574                      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>
1575                      command.                      command.
1576  </p>  </p>
1577  <p>Possible Answers:  <p>Possible Answers:
# Line 1545  Intellectual Property and Copyright Stat Line 1624  Intellectual Property and Copyright Stat
1624                                            
1625  </p>  </p>
1626  <a name="GET AUDIO_OUTPUT_DEVICES"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1627  <table summary="layout" 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>
1628  <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;
1629    Getting all created audio output device count</h3>
1630    
1631  <p>Use the following command to count all created audio output devices:  <p>Use the following command to count all created audio output devices:
1632  </p>  </p>
# Line 1582  Intellectual Property and Copyright Stat Line 1662  Intellectual Property and Copyright Stat
1662                                            
1663  </p>  </p>
1664  <a name="LIST AUDIO_OUTPUT_DEVICES"></a><br /><hr />  <a name="LIST AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1665  <table summary="layout" 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>
1666  <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;
1667    Getting all created audio output device list</h3>
1668    
1669  <p>Use the following command to list all created audio output devices:  <p>Use the following command to list all created audio output devices:
1670  </p>  </p>
# Line 1619  Intellectual Property and Copyright Stat Line 1700  Intellectual Property and Copyright Stat
1700                                            
1701  </p>  </p>
1702  <a name="GET AUDIO_OUTPUT_DEVICE INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_DEVICE INFO"></a><br /><hr />
1703  <table summary="layout" 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>
1704  <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;
1705    Getting current settings of an audio output device</h3>
1706    
1707  <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:
1708  </p>  </p>
# Line 1634  Intellectual Property and Copyright Stat Line 1716  Intellectual Property and Copyright Stat
1716  </p>  </p>
1717  <p>Where &lt;device-id&gt; should be replaced by numerical ID  <p>Where &lt;device-id&gt; should be replaced by numerical ID
1718                      of the audio output device as e.g. returned by the                      of the audio output device as e.g. returned by the
1719                      <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.
1720  </p>  </p>
1721  <p>Possible Answers:  <p>Possible Answers:
1722  </p>  </p>
# Line 1654  Intellectual Property and Copyright Stat Line 1736  Intellectual Property and Copyright Stat
1736  <blockquote class="text">  <blockquote class="text">
1737  <p>identifier of the used audio output driver, as also  <p>identifier of the used audio output driver, as also
1738                                      returned by the                                      returned by the
1739                                      <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>
1740                                      command                                      command
1741  </p>  </p>
1742  </blockquote>  </blockquote>
# Line 1695  Intellectual Property and Copyright Stat Line 1777  Intellectual Property and Copyright Stat
1777                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
1778                      returned by all audio output devices. Every audio output driver                      returned by all audio output devices. Every audio output driver
1779                      might have its own, additional driver specific parameters (see                      might have its own, additional driver specific parameters (see
1780                      <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>)
1781                      which are also returned by this command.                      which are also returned by this command.
1782  </p>  </p>
1783  <p>Example:  <p>Example:
# Line 1725  Intellectual Property and Copyright Stat Line 1807  Intellectual Property and Copyright Stat
1807                                            
1808  </p>  </p>
1809  <a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER"></a><br /><hr />  <a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER"></a><br /><hr />
1810  <table summary="layout" 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>
1811  <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;
1812    Changing settings of audio output devices</h3>
1813    
1814  <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:
1815  </p>  </p>
# Line 1740  Intellectual Property and Copyright Stat Line 1823  Intellectual Property and Copyright Stat
1823  </p>  </p>
1824  <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
1825                      audio output device as given by the                      audio output device as given by the
1826                      <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>
1827                      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>
1828                      command, &lt;key&gt; by the name of the parameter to change                      command, &lt;key&gt; by the name of the parameter to change
1829                      and &lt;value&gt; by the new value for this parameter.                      and &lt;value&gt; by the new value for this parameter.
1830  </p>  </p>
# Line 1793  Intellectual Property and Copyright Stat Line 1876  Intellectual Property and Copyright Stat
1876                                            
1877  </p>  </p>
1878  <a name="GET AUDIO_OUTPUT_CHANNEL INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_CHANNEL INFO"></a><br /><hr />
1879  <table summary="layout" 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>
1880  <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;
1881    Getting information about an audio channel</h3>
1882    
1883  <p>Use the following command to get information about an audio channel:  <p>Use the following command to get information about an audio channel:
1884  </p>  </p>
# Line 1807  Intellectual Property and Copyright Stat Line 1891  Intellectual Property and Copyright Stat
1891                                            
1892  </p>  </p>
1893  <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
1894                      <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>
1895                      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>
1896                      command and &lt;audio-chan&gt; the audio channel number.                      command and &lt;audio-chan&gt; the audio channel number.
1897  </p>  </p>
1898  <p>Possible Answers:  <p>Possible Answers:
# Line 1935  Intellectual Property and Copyright Stat Line 2019  Intellectual Property and Copyright Stat
2019                                            
2020  </p>  </p>
2021  <a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO"></a><br /><hr />  <a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO"></a><br /><hr />
2022  <table summary="layout" 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>
2023  <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;
2024    Getting information about specific audio channel parameter</h3>
2025    
2026  <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:
2027  </p>  </p>
# Line 1949  Intellectual Property and Copyright Stat Line 2034  Intellectual Property and Copyright Stat
2034                                            
2035  </p>  </p>
2036  <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
2037                      <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>
2038                      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>
2039                      command, &lt;chan&gt; the audio channel number                      command, &lt;chan&gt; the audio channel number
2040                      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
2041                      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).
2042  </p>  </p>
2043  <p>Possible Answers:  <p>Possible Answers:
2044  </p>  </p>
# Line 2081  Intellectual Property and Copyright Stat Line 2166  Intellectual Property and Copyright Stat
2166                                            
2167  </p>  </p>
2168  <a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER"></a><br /><hr />  <a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER"></a><br /><hr />
2169  <table summary="layout" 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>
2170  <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;
2171    Changing settings of audio output channels</h3>
2172    
2173  <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:
2174  </p>  </p>
# Line 2095  Intellectual Property and Copyright Stat Line 2181  Intellectual Property and Copyright Stat
2181                                            
2182  </p>  </p>
2183  <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
2184                      <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>
2185                      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>
2186                      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
2187                      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.
2188  </p>  </p>
# Line 2158  Intellectual Property and Copyright Stat Line 2244  Intellectual Property and Copyright Stat
2244                                            
2245  </p>  </p>
2246  <a name="anchor10"></a><br /><hr />  <a name="anchor10"></a><br /><hr />
2247  <table summary="layout" 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>
2248  <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;
2249    Configuring MIDI input drivers</h3>
2250    
2251  <p>Instances of drivers in LinuxSampler are called devices. You can use  <p>Instances of drivers in LinuxSampler are called devices. You can use
2252                  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 2275  Intellectual Property and Copyright Stat
2275                  possible values, etc.                  possible values, etc.
2276  </p>  </p>
2277  <a name="GET AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />  <a name="GET AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2278  <table summary="layout" 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>
2279  <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;
2280    Getting amount of available MIDI input drivers</h3>
2281    
2282  <p>Use the following command to get the number of  <p>Use the following command to get the number of
2283                      MIDI input drivers currently available for the                      MIDI input drivers currently available for the
# Line 2227  Intellectual Property and Copyright Stat Line 2315  Intellectual Property and Copyright Stat
2315                                            
2316  </p>  </p>
2317  <a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />  <a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2318  <table summary="layout" 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>
2319  <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;
2320    Getting all available MIDI input drivers</h3>
2321    
2322  <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
2323                      for the LinuxSampler instance:                      for the LinuxSampler instance:
# Line 2265  Intellectual Property and Copyright Stat Line 2354  Intellectual Property and Copyright Stat
2354                                            
2355  </p>  </p>
2356  <a name="GET MIDI_INPUT_DRIVER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DRIVER INFO"></a><br /><hr />
2357  <table summary="layout" 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>
2358  <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;
2359    Getting information about a specific MIDI input driver</h3>
2360    
2361  <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:
2362  </p>  </p>
# Line 2279  Intellectual Property and Copyright Stat Line 2369  Intellectual Property and Copyright Stat
2369                                            
2370  </p>  </p>
2371  <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
2372                      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.
2373  </p>  </p>
2374  <p>Possible Answers:  <p>Possible Answers:
2375  </p>  </p>
# Line 2346  Intellectual Property and Copyright Stat Line 2436  Intellectual Property and Copyright Stat
2436                                            
2437  </p>  </p>
2438  <a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
2439  <table summary="layout" 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>
2440  <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;
2441    Getting information about specific MIDI input driver parameter</h3>
2442    
2443  <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:
2444  </p>  </p>
# Line 2360  Intellectual Property and Copyright Stat Line 2451  Intellectual Property and Copyright Stat
2451                                            
2452  </p>  </p>
2453  <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
2454                      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
2455                      parameter name for which information should be obtained (as returned by the                      parameter name for which information should be obtained (as returned by the
2456                      <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
2457                      of parameters on which the sought parameter &lt;param&gt; depends on,                      of parameters on which the sought parameter &lt;param&gt; depends on,
2458                      &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 ...",
2459                      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 2500  Intellectual Property and Copyright Stat
2500  <blockquote class="text">  <blockquote class="text">
2501  <p>either true or false, defines if this parameter must be  <p>either true or false, defines if this parameter must be
2502                                  given when the device is to be created with the                                  given when the device is to be created with the
2503                                  <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
2504                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2505  </p>  </p>
2506  </blockquote>  </blockquote>
# Line 2420  Intellectual Property and Copyright Stat Line 2511  Intellectual Property and Copyright Stat
2511  <blockquote class="text">  <blockquote class="text">
2512  <p>either true or false, if false then this parameter can  <p>either true or false, if false then this parameter can
2513                                  be changed at any time, once the device is created by                                  be changed at any time, once the device is created by
2514                                  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
2515                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2516  </p>  </p>
2517  </blockquote>  </blockquote>
# Line 2459  Intellectual Property and Copyright Stat Line 2550  Intellectual Property and Copyright Stat
2550  <blockquote class="text">  <blockquote class="text">
2551  <p>reflects the default value for this parameter which is  <p>reflects the default value for this parameter which is
2552                                  used when the device is created and not explicitly                                  used when the device is created and not explicitly
2553                                  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,
2554                                  in case of MULTIPLCITY=true, this is a comma separated                                  in case of MULTIPLCITY=true, this is a comma separated
2555                                  list, that's why character strings are encapsulated into                                  list, that's why character strings are encapsulated into
2556                                  apostrophes (')                                  apostrophes (')
# Line 2533  Intellectual Property and Copyright Stat Line 2624  Intellectual Property and Copyright Stat
2624                                            
2625  </p>  </p>
2626  <a name="CREATE MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="CREATE MIDI_INPUT_DEVICE"></a><br /><hr />
2627  <table summary="layout" 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>
2628  <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;
2629    Creating a MIDI input device</h3>
2630    
2631  <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:
2632  </p>  </p>
# Line 2547  Intellectual Property and Copyright Stat Line 2639  Intellectual Property and Copyright Stat
2639                                            
2640  </p>  </p>
2641  <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
2642                      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
2643                      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
2644                      character string values should be encapsulated into apostrophes (').                      character string values should be encapsulated into apostrophes (').
2645                      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 2695  Intellectual Property and Copyright Stat
2695                                            
2696  </p>  </p>
2697  <a name="DESTROY MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="DESTROY MIDI_INPUT_DEVICE"></a><br /><hr />
2698  <table summary="layout" 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>
2699  <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;
2700    Destroying a MIDI input device</h3>
2701    
2702  <p>Use the following command to destroy a created MIDI input device:  <p>Use the following command to destroy a created MIDI input device:
2703  </p>  </p>
# Line 2617  Intellectual Property and Copyright Stat Line 2710  Intellectual Property and Copyright Stat
2710                                            
2711  </p>  </p>
2712  <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
2713                      <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>
2714                      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>
2715                      command.                      command.
2716  </p>  </p>
2717  <p>Possible Answers:  <p>Possible Answers:
# Line 2668  Intellectual Property and Copyright Stat Line 2761  Intellectual Property and Copyright Stat
2761                                            
2762  </p>  </p>
2763  <a name="GET MIDI_INPUT_DEVICES"></a><br /><hr />  <a name="GET MIDI_INPUT_DEVICES"></a><br /><hr />
2764  <table summary="layout" 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>
2765  <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;
2766    Getting all created MIDI input device count</h3>
2767    
2768  <p>Use the following command to count all created MIDI input devices:  <p>Use the following command to count all created MIDI input devices:
2769  </p>  </p>
# Line 2705  Intellectual Property and Copyright Stat Line 2799  Intellectual Property and Copyright Stat
2799                                            
2800  </p>  </p>
2801  <a name="LIST MIDI_INPUT_DEVICES"></a><br /><hr />  <a name="LIST MIDI_INPUT_DEVICES"></a><br /><hr />
2802  <table summary="layout" 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>
2803  <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;
2804    Getting all created MIDI input device list</h3>
2805    
2806  <p>Use the following command to list all created MIDI input devices:  <p>Use the following command to list all created MIDI input devices:
2807  </p>  </p>
# Line 2752  Intellectual Property and Copyright Stat Line 2847  Intellectual Property and Copyright Stat
2847                                            
2848  </p>  </p>
2849  <a name="GET MIDI_INPUT_DEVICE INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_DEVICE INFO"></a><br /><hr />
2850  <table summary="layout" 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>
2851  <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;
2852    Getting current settings of a MIDI input device</h3>
2853    
2854  <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:
2855  </p>  </p>
# Line 2766  Intellectual Property and Copyright Stat Line 2862  Intellectual Property and Copyright Stat
2862                                            
2863  </p>  </p>
2864  <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
2865                      <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>
2866                      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>
2867                      command.                      command.
2868  </p>  </p>
2869  <p>Possible Answers:  <p>Possible Answers:
# Line 2790  Intellectual Property and Copyright Stat Line 2886  Intellectual Property and Copyright Stat
2886                                          </p>                                          </p>
2887  <blockquote class="text">  <blockquote class="text">
2888  <p>identifier of the used MIDI input driver, as e.g.  <p>identifier of the used MIDI input driver, as e.g.
2889                                              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>
2890                                              command                                              command
2891  </p>  </p>
2892  </blockquote>  </blockquote>
# Line 2820  Intellectual Property and Copyright Stat Line 2916  Intellectual Property and Copyright Stat
2916                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
2917                      returned by all MIDI input devices. Every MIDI input driver                      returned by all MIDI input devices. Every MIDI input driver
2918                      might have its own, additional driver specific parameters (see                      might have its own, additional driver specific parameters (see
2919                      <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
2920                      by this command.                      by this command.
2921  </p>  </p>
2922  <p>Example:  <p>Example:
# Line 2840  Intellectual Property and Copyright Stat Line 2936  Intellectual Property and Copyright Stat
2936                                            
2937  </p>  </p>
2938  <a name="SET MIDI_INPUT_DEVICE_PARAMETER"></a><br /><hr />  <a name="SET MIDI_INPUT_DEVICE_PARAMETER"></a><br /><hr />
2939  <table summary="layout" 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>
2940  <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;
2941    Changing settings of MIDI input devices</h3>
2942    
2943  <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:
2944  </p>  </p>
# Line 2855  Intellectual Property and Copyright Stat Line 2952  Intellectual Property and Copyright Stat
2952  </p>  </p>
2953  <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
2954                      MIDI input device as returned by the                      MIDI input device as returned by the
2955                      <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>
2956                      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>
2957                      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
2958                      &lt;value&gt; by the new value for this parameter.                      &lt;value&gt; by the new value for this parameter.
2959  </p>  </p>
# Line 2907  Intellectual Property and Copyright Stat Line 3004  Intellectual Property and Copyright Stat
3004                                            
3005  </p>  </p>
3006  <a name="GET MIDI_INPUT_PORT INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_PORT INFO"></a><br /><hr />
3007  <table summary="layout" 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>
3008  <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;
3009    Getting information about a MIDI port</h3>
3010    
3011  <p>Use the following command to get information about a MIDI port:  <p>Use the following command to get information about a MIDI port:
3012  </p>  </p>
# Line 2921  Intellectual Property and Copyright Stat Line 3019  Intellectual Property and Copyright Stat
3019                                            
3020  </p>  </p>
3021  <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
3022                      <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>
3023                      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>
3024                      command and &lt;midi-port&gt; the MIDI input port number.                      command and &lt;midi-port&gt; the MIDI input port number.
3025  </p>  </p>
3026  <p>Possible Answers:  <p>Possible Answers:
# Line 2969  Intellectual Property and Copyright Stat Line 3067  Intellectual Property and Copyright Stat
3067                                            
3068  </p>  </p>
3069  <a name="GET MIDI_INPUT_PORT_PARAMETER INFO"></a><br /><hr />  <a name="GET MIDI_INPUT_PORT_PARAMETER INFO"></a><br /><hr />
3070  <table summary="layout" 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>
3071  <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;
3072    Getting information about specific MIDI port parameter</h3>
3073    
3074  <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:
3075  </p>  </p>
# Line 2983  Intellectual Property and Copyright Stat Line 3082  Intellectual Property and Copyright Stat
3082                                            
3083  </p>  </p>
3084  <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
3085                      <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>
3086                      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>
3087                      command, &lt;port&gt; the MIDI port number and                      command, &lt;port&gt; the MIDI port number and
3088                      &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
3089                      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).
3090  </p>  </p>
3091  <p>Possible Answers:  <p>Possible Answers:
3092  </p>  </p>
# Line 3110  Intellectual Property and Copyright Stat Line 3209  Intellectual Property and Copyright Stat
3209                                            
3210  </p>  </p>
3211  <a name="SET MIDI_INPUT_PORT_PARAMETER"></a><br /><hr />  <a name="SET MIDI_INPUT_PORT_PARAMETER"></a><br /><hr />
3212  <table summary="layout" 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>
3213  <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;
3214    Changing settings of MIDI input ports</h3>
3215    
3216  <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:
3217  </p>  </p>
# Line 3125  Intellectual Property and Copyright Stat Line 3225  Intellectual Property and Copyright Stat
3225  </p>  </p>
3226  <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
3227                      MIDI device as returned by the                      MIDI device as returned by the
3228                      <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>
3229                      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>
3230                      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
3231                      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
3232                      parameter.                      parameter.
# Line 3176  Intellectual Property and Copyright Stat Line 3276  Intellectual Property and Copyright Stat
3276                                            
3277  </p>  </p>
3278  <a name="anchor11"></a><br /><hr />  <a name="anchor11"></a><br /><hr />
3279  <table summary="layout" 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>
3280  <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;
3281    Configuring sampler channels</h3>
3282    
3283  <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
3284                  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
3285                  MIDI and audio devices.                  MIDI and audio devices.
3286  </p>  </p>
3287  <a name="LOAD INSTRUMENT"></a><br /><hr />  <a name="LOAD INSTRUMENT"></a><br /><hr />
3288  <table summary="layout" 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>
3289  <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;
3290    Loading an instrument</h3>
3291    
3292  <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:
3293  </p>  </p>
# Line 3207  Intellectual Property and Copyright Stat Line 3309  Intellectual Property and Copyright Stat
3309                      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
3310                      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
3311                      returns immediately and a background process is launched to load the instrument                      returns immediately and a background process is launched to load the instrument
3312                      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>
3313                      command can be used to obtain loading                      command can be used to obtain loading
3314                      progress from INSTRUMENT_STATUS field. LOAD command will perform sanity checks                      progress from INSTRUMENT_STATUS field. LOAD command will perform sanity checks
3315                      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 3363  Intellectual Property and Copyright Stat
3363                                            
3364  </p>  </p>
3365  <a name="LOAD ENGINE"></a><br /><hr />  <a name="LOAD ENGINE"></a><br /><hr />
3366  <table summary="layout" 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>
3367  <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;
3368    Loading a sampler engine</h3>
3369    
3370  <p>A sampler engine type can be associated to a specific sampler  <p>A sampler engine type can be associated to a specific sampler
3371                      channel by the following command:                      channel by the following command:
# Line 3276  Intellectual Property and Copyright Stat Line 3379  Intellectual Property and Copyright Stat
3379                                            
3380  </p>  </p>
3381  <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
3382                      <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;
3383                      the sampler channel as returned by the                      the sampler channel as returned by the
3384                      <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
3385                      <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
3386                      the engine type should be assigned to. This command should be issued                      the engine type should be assigned to. This command should be issued
3387                      after adding a new sampler channel and before any other control                      after adding a new sampler channel and before any other control
3388                      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 3438  Intellectual Property and Copyright Stat
3438                                            
3439  </p>  </p>
3440  <a name="GET CHANNELS"></a><br /><hr />  <a name="GET CHANNELS"></a><br /><hr />
3441  <table summary="layout" 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>
3442  <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;
3443    Getting all created sampler channel count</h3>
3444    
3445  <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
3446                      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 3477  Intellectual Property and Copyright Stat
3477                                            
3478  </p>  </p>
3479  <a name="LIST CHANNELS"></a><br /><hr />  <a name="LIST CHANNELS"></a><br /><hr />
3480  <table summary="layout" 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>
3481  <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;
3482    Getting all created sampler channel list</h3>
3483    
3484  <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
3485                      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 3517  Intellectual Property and Copyright Stat
3517                                            
3518  </p>  </p>
3519  <a name="ADD CHANNEL"></a><br /><hr />  <a name="ADD CHANNEL"></a><br /><hr />
3520  <table summary="layout" 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>
3521  <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;
3522    Adding a new sampler channel</h3>
3523    
3524  <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
3525                      channel list by sending the following command:                      channel list by sending the following command:
# Line 3486  Intellectual Property and Copyright Stat Line 3592  Intellectual Property and Copyright Stat
3592                                            
3593  </p>  </p>
3594  <a name="REMOVE CHANNEL"></a><br /><hr />  <a name="REMOVE CHANNEL"></a><br /><hr />
3595  <table summary="layout" 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>
3596  <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;
3597    Removing a sampler channel</h3>
3598    
3599  <p>A sampler channel can be removed by sending the following command:  <p>A sampler channel can be removed by sending the following command:
3600  </p>  </p>
# Line 3501  Intellectual Property and Copyright Stat Line 3608  Intellectual Property and Copyright Stat
3608  </p>  </p>
3609  <p>Where &lt;sampler-channel&gt; should be replaced by the  <p>Where &lt;sampler-channel&gt; should be replaced by the
3610                      number of the sampler channel as given by the                      number of the sampler channel as given by the
3611                      <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>
3612                      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>
3613                      command. The channel numbers of all subsequent sampler channels                      command. The channel numbers of all subsequent sampler channels
3614                      remain the same.                      remain the same.
3615  </p>  </p>
# Line 3552  Intellectual Property and Copyright Stat Line 3659  Intellectual Property and Copyright Stat
3659                                            
3660  </p>  </p>
3661  <a name="GET AVAILABLE_ENGINES"></a><br /><hr />  <a name="GET AVAILABLE_ENGINES"></a><br /><hr />
3662  <table summary="layout" 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>
3663  <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;
3664    Getting amount of available engines</h3>
3665    
3666  <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:
3667  </p>  </p>
# Line 3588  Intellectual Property and Copyright Stat Line 3696  Intellectual Property and Copyright Stat
3696                                            
3697  </p>  </p>
3698  <a name="LIST AVAILABLE_ENGINES"></a><br /><hr />  <a name="LIST AVAILABLE_ENGINES"></a><br /><hr />
3699  <table summary="layout" 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>
3700  <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;
3701    Getting all available engines</h3>
3702    
3703  <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:
3704  </p>  </p>
# Line 3627  Intellectual Property and Copyright Stat Line 3736  Intellectual Property and Copyright Stat
3736                                            
3737  </p>  </p>
3738  <a name="GET ENGINE INFO"></a><br /><hr />  <a name="GET ENGINE INFO"></a><br /><hr />
3739  <table summary="layout" 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>
3740  <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;
3741    Getting information about an engine</h3>
3742    
3743  <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
3744                      sending the following command:                      sending the following command:
# Line 3642  Intellectual Property and Copyright Stat Line 3752  Intellectual Property and Copyright Stat
3752                                            
3753  </p>  </p>
3754  <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
3755                      <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.
3756  </p>  </p>
3757  <p>Possible Answers:  <p>Possible Answers:
3758  </p>  </p>
# Line 3699  Intellectual Property and Copyright Stat Line 3809  Intellectual Property and Copyright Stat
3809                                            
3810  </p>  </p>
3811  <a name="GET CHANNEL INFO"></a><br /><hr />  <a name="GET CHANNEL INFO"></a><br /><hr />
3812  <table summary="layout" 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>
3813  <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;
3814    Getting sampler channel information</h3>
3815    
3816  <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
3817                      by sending the following command:                      by sending the following command:
# Line 3714  Intellectual Property and Copyright Stat Line 3825  Intellectual Property and Copyright Stat
3825                                            
3826  </p>  </p>
3827  <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
3828                      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>
3829                      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.
3830  </p>  </p>
3831  <p>Possible Answers:  <p>Possible Answers:
3832  </p>  </p>
# Line 3870  Intellectual Property and Copyright Stat Line 3981  Intellectual Property and Copyright Stat
3981  </blockquote>  </blockquote>
3982                                                                            
3983    
3984    <p>MIDI_INSTRUMENT_MAP -
3985                                            </p>
3986    <blockquote class="text">
3987    <p>Determines to which MIDI instrument map this sampler
3988                                                channel is assigned to. Read chapter
3989                                                <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>
3990                                                for a list of possible values.
3991    </p>
3992    </blockquote>
3993                                        
3994    
3995  </blockquote>  </blockquote>
3996                                                            
3997    
# Line 3909  Intellectual Property and Copyright Stat Line 4031  Intellectual Property and Copyright Stat
4031  </p>  </p>
4032  <p>&nbsp;&nbsp;&nbsp;"MIDI_INPUT_CHANNEL: 5"  <p>&nbsp;&nbsp;&nbsp;"MIDI_INPUT_CHANNEL: 5"
4033  </p>  </p>
4034    <p>&nbsp;&nbsp;&nbsp;"VOLUME: 1.0"
4035    </p>
4036    <p>&nbsp;&nbsp;&nbsp;"MUTE: false"
4037    </p>
4038    <p>&nbsp;&nbsp;&nbsp;"SOLO: false"
4039    </p>
4040    <p>&nbsp;&nbsp;&nbsp;"MIDI_INSTRUMENT_MAP: NONE"
4041    </p>
4042  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
4043  </p>  </p>
4044  </blockquote><p>  </blockquote><p>
4045                                            
4046  </p>  </p>
4047  <a name="GET CHANNEL VOICE_COUNT"></a><br /><hr />  <a name="GET CHANNEL VOICE_COUNT"></a><br /><hr />
4048  <table summary="layout" 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>
4049  <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;
4050    Current number of active voices</h3>
4051    
4052  <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
4053                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 3930  Intellectual Property and Copyright Stat Line 4061  Intellectual Property and Copyright Stat
4061                                            
4062  </p>  </p>
4063  <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
4064                      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>
4065                      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.
4066  </p>  </p>
4067  <p>Possible Answers:  <p>Possible Answers:
4068  </p>  </p>
# Line 3955  Intellectual Property and Copyright Stat Line 4086  Intellectual Property and Copyright Stat
4086                                            
4087  </p>  </p>
4088  <a name="GET CHANNEL STREAM_COUNT"></a><br /><hr />  <a name="GET CHANNEL STREAM_COUNT"></a><br /><hr />
4089  <table summary="layout" 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>
4090  <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;
4091    Current number of active disk streams</h3>
4092    
4093  <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
4094                      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 4102  Intellectual Property and Copyright Stat
4102                                            
4103  </p>  </p>
4104  <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
4105                      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>
4106                      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.
4107  </p>  </p>
4108  <p>Possible Answers:  <p>Possible Answers:
4109  </p>  </p>
# Line 3997  Intellectual Property and Copyright Stat Line 4129  Intellectual Property and Copyright Stat
4129                                            
4130  </p>  </p>
4131  <a name="GET CHANNEL BUFFER_FILL"></a><br /><hr />  <a name="GET CHANNEL BUFFER_FILL"></a><br /><hr />
4132  <table summary="layout" 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>
4133  <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;
4134    Current fill state of disk stream buffers</h3>
4135    
4136  <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
4137                      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 4156  Intellectual Property and Copyright Stat
4156  </p>  </p>
4157  <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
4158                      sampler channel number the front-end is interested in                      sampler channel number the front-end is interested in
4159                      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>
4160                      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.
4161  </p>  </p>
4162  <p>Possible Answers:  <p>Possible Answers:
4163  </p>  </p>
# Line 4074  Intellectual Property and Copyright Stat Line 4207  Intellectual Property and Copyright Stat
4207                                            
4208  </p>  </p>
4209  <a name="SET CHANNEL AUDIO_OUTPUT_DEVICE"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_DEVICE"></a><br /><hr />
4210  <table summary="layout" 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>
4211  <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;
4212    Setting audio output device</h3>
4213    
4214  <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
4215                      channel by sending the following command:                      channel by sending the following command:
# Line 4089  Intellectual Property and Copyright Stat Line 4223  Intellectual Property and Copyright Stat
4223                                            
4224  </p>  </p>
4225  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4226                      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>
4227                      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
4228                      &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
4229                      <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>
4230                      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>
4231                      command.                      command.
4232  </p>  </p>
4233  <p>Possible Answers:  <p>Possible Answers:
# Line 4140  Intellectual Property and Copyright Stat Line 4274  Intellectual Property and Copyright Stat
4274  </blockquote><p>  </blockquote><p>
4275                                            
4276  </p>  </p>
4277  <a name="SET CHANNEL AUDIO_OUTPUT_TYP"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_TYPE"></a><br /><hr />
4278  <table summary="layout" 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>
4279  <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;
4280    Setting audio output type</h3>
4281    
4282  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4283  </p>  </p>
# Line 4205  Intellectual Property and Copyright Stat Line 4340  Intellectual Property and Copyright Stat
4340                                            
4341  </p>  </p>
4342  <a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr />  <a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr />
4343  <table summary="layout" 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>
4344  <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;
4345    Setting audio output channel</h3>
4346    
4347  <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
4348                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 4220  Intellectual Property and Copyright Stat Line 4356  Intellectual Property and Copyright Stat
4356                                            
4357  </p>  </p>
4358  <p>Where &lt;sampler-chan&gt; is the sampler channel number  <p>Where &lt;sampler-chan&gt; is the sampler channel number
4359                      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>
4360                      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
4361                      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
4362                      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
4363                      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 4407  Intellectual Property and Copyright Stat
4407                                            
4408  </p>  </p>
4409  <a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr />
4410  <table summary="layout" 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>
4411  <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;
4412    Setting MIDI input device</h3>
4413    
4414  <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
4415                      channel by sending the following command:                      channel by sending the following command:
# Line 4286  Intellectual Property and Copyright Stat Line 4423  Intellectual Property and Copyright Stat
4423                                            
4424  </p>  </p>
4425  <p>Where &lt;sampler-channel&gt; is the sampler channel number  <p>Where &lt;sampler-channel&gt; is the sampler channel number
4426                      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>
4427                      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
4428                      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
4429                      <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>
4430                      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.
4431  </p>  </p>
4432  <p>Possible Answers:  <p>Possible Answers:
4433  </p>  </p>
# Line 4337  Intellectual Property and Copyright Stat Line 4474  Intellectual Property and Copyright Stat
4474                                            
4475  </p>  </p>
4476  <a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr />
4477  <table summary="layout" 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>
4478  <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;
4479    Setting MIDI input type</h3>
4480    
4481  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4482  </p>  </p>
# Line 4401  Intellectual Property and Copyright Stat Line 4539  Intellectual Property and Copyright Stat
4539                                            
4540  </p>  </p>
4541  <a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr />
4542  <table summary="layout" 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>
4543  <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;
4544    Setting MIDI input port</h3>
4545    
4546  <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
4547                      channel by sending the following command:                      channel by sending the following command:
# Line 4464  Intellectual Property and Copyright Stat Line 4603  Intellectual Property and Copyright Stat
4603                                            
4604  </p>  </p>
4605  <a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr />  <a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr />
4606  <table summary="layout" 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>
4607  <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;
4608    Setting MIDI input channel</h3>
4609    
4610  <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
4611                      listen to by sending the following command:                      listen to by sending the following command:
# Line 4527  Intellectual Property and Copyright Stat Line 4667  Intellectual Property and Copyright Stat
4667                                            
4668  </p>  </p>
4669  <a name="SET CHANNEL VOLUME"></a><br /><hr />  <a name="SET CHANNEL VOLUME"></a><br /><hr />
4670  <table summary="layout" 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>
4671  <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;
4672    Setting channel volume</h3>
4673    
4674  <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
4675                      the following command:                      the following command:
# Line 4591  Intellectual Property and Copyright Stat Line 4732  Intellectual Property and Copyright Stat
4732                                            
4733  </p>  </p>
4734  <a name="SET CHANNEL MUTE"></a><br /><hr />  <a name="SET CHANNEL MUTE"></a><br /><hr />
4735  <table summary="layout" 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>
4736  <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;
4737    Muting a sampler channel</h3>
4738    
4739  <p>The front-end can mute/unmute a specific sampler  <p>The front-end can mute/unmute a specific sampler
4740                      channel by sending the following command:                      channel by sending the following command:
# Line 4606  Intellectual Property and Copyright Stat Line 4748  Intellectual Property and Copyright Stat
4748                                            
4749  </p>  </p>
4750  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4751                      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>
4752                      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
4753                      &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"
4754                      to unmute the channel.                      to unmute the channel.
4755  </p>  </p>
# Line 4656  Intellectual Property and Copyright Stat Line 4798  Intellectual Property and Copyright Stat
4798                                            
4799  </p>  </p>
4800  <a name="SET CHANNEL SOLO"></a><br /><hr />  <a name="SET CHANNEL SOLO"></a><br /><hr />
4801  <table summary="layout" 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>
4802  <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;
4803    Soloing a sampler channel</h3>
4804    
4805  <p>The front-end can solo/unsolo a specific sampler channel  <p>The front-end can solo/unsolo a specific sampler channel
4806                      by sending the following command:                      by sending the following command:
# Line 4671  Intellectual Property and Copyright Stat Line 4814  Intellectual Property and Copyright Stat
4814                                            
4815  </p>  </p>
4816  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4817                      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>
4818                      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
4819                      &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"
4820                      to unsolo the channel.                      to unsolo the channel.
4821  </p>  </p>
# Line 4720  Intellectual Property and Copyright Stat Line 4863  Intellectual Property and Copyright Stat
4863  </blockquote><p>  </blockquote><p>
4864                                            
4865  </p>  </p>
4866    <a name="SET CHANNEL MIDI_INSTRUMENT_MAP"></a><br /><hr />
4867    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4868    <a name="rfc.section.6.4.24"></a><h3>6.4.24.&nbsp;
4869    Assigning a MIDI instrument map to a sampler channel</h3>
4870    
4871    <p>The front-end can assign a MIDI instrument map to a specific sampler channel
4872                        by sending the following command:
4873    </p>
4874    <p>
4875                            </p>
4876    <blockquote class="text">
4877    <p>SET CHANNEL MIDI_INSTRUMENT_MAP &lt;sampler-channel&gt; &lt;map&gt;
4878    </p>
4879    </blockquote><p>
4880                        
4881    </p>
4882    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4883                        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>
4884                        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
4885                        &lt;map&gt; can have the following possibilites:
4886    </p>
4887    <p>
4888                            </p>
4889    <blockquote class="text">
4890    <p>"NONE" -
4891                                    </p>
4892    <blockquote class="text">
4893    <p>This is the default setting. In this case
4894                                        the sampler channel is not assigned any MIDI
4895                                        instrument map and thus will ignore all MIDI
4896                                        program change messages.
4897    </p>
4898    </blockquote>
4899                                
4900    
4901    <p>"DEFAULT" -
4902                                    </p>
4903    <blockquote class="text">
4904    <p>The sampler channel will always use the
4905                                        default MIDI instrument map to handle MIDI
4906                                        program change messages.
4907    </p>
4908    </blockquote>
4909                                
4910    
4911    <p>numeric ID -
4912                                    </p>
4913    <blockquote class="text">
4914    <p>You can assign a specific MIDI instrument map
4915                                        by replacing &lt;map&gt; with the respective numeric
4916                                        ID of the MIDI instrument map as returned by the
4917                                        <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>
4918                                        command. Once that map will be deleted, the sampler
4919                                        channel would fall back to "NONE".
4920    </p>
4921    </blockquote>
4922                                
4923    
4924    </blockquote><p>
4925                        
4926    </p>
4927    <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>
4928                        for details regarding MIDI instrument mapping.
4929    </p>
4930    <p>Possible Answers:
4931    </p>
4932    <p>
4933                            </p>
4934    <blockquote class="text">
4935    <p>"OK" -
4936                                    </p>
4937    <blockquote class="text">
4938    <p>on success
4939    </p>
4940    </blockquote>
4941                                
4942    
4943    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4944                                    </p>
4945    <blockquote class="text">
4946    <p>in case it failed, providing an appropriate error code and error message
4947    </p>
4948    </blockquote>
4949                                
4950    
4951    </blockquote><p>
4952                        
4953    </p>
4954    <p>Examples:
4955    </p>
4956    <p>
4957                            </p>
4958    <blockquote class="text">
4959    <p>
4960    </p>
4961    </blockquote><p>
4962                        
4963    </p>
4964    <a name="CREATE FX_SEND"></a><br /><hr />
4965    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
4966    <a name="rfc.section.6.4.25"></a><h3>6.4.25.&nbsp;
4967    Adding an effect send to a sampler channel</h3>
4968    
4969    <p>The front-end can create an additional effect send on a specific sampler channel
4970                        by sending the following command:
4971    </p>
4972    <p>
4973                            </p>
4974    <blockquote class="text">
4975    <p>CREATE FX_SEND &lt;sampler-channel&gt; &lt;midi-ctrl&gt; [&lt;name&gt;]
4976    </p>
4977    </blockquote><p>
4978                        
4979    </p>
4980    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4981                        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>
4982                        or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command, that is the
4983                        sampler channel on which the effect send should be created on, &lt;midi-ctrl&gt;
4984                        is a number between 0..127 defining the MIDI controller which can alter the
4985                        effect send level and &lt;name&gt; is an optional argument defining a name
4986                        for the effect send entity. The name does not have to be unique.
4987    </p>
4988    <p>By default, that is as initial routing, the effect send's audio channels
4989                        are automatically routed to the last audio channels of the sampler channel's
4990                        audio output device, that way you can i.e. first increase the amount of audio
4991                        channels on the audio output device for having dedicated effect send output
4992                        channels and when "CREATE FX_SEND" is called, those channels will automatically
4993                        be picked. You can alter the destination channels however with
4994                        <a class='info' href='#SET FX_SEND AUDIO_OUTPUT_CHANNEL'>"SET FX_SEND AUDIO_OUTPUT_CHANNEL"<span> (</span><span class='info'>Altering effect send's audio routing</span><span>)</span></a>.
4995                        
4996    </p>
4997    <p>Note: Create effect sends on a sampler channel only when needed, because having effect
4998                        sends on a sampler channel will decrease runtime performance, because for implementing channel
4999                        effect sends, separate (sampler channel local) audio buffers are needed to render and mix
5000                        the voices and route the audio signal afterwards to the master outputs and effect send
5001                        outputs (along with their respective effect send levels). A sampler channel without effect
5002                        sends however can mix its voices directly into the audio output devices's audio buffers
5003                        and is thus faster.
5004                        
5005    </p>
5006    <p>Possible Answers:
5007    </p>
5008    <p>
5009                            </p>
5010    <blockquote class="text">
5011    <p>"OK[&lt;fx-send-id&gt;]" -
5012                                    </p>
5013    <blockquote class="text">
5014    <p>in case a new effect send could be added to the
5015                                        sampler channel, where &lt;fx-send-id&gt; reflects the
5016                                        unique ID of the newly created effect send entity
5017    </p>
5018    </blockquote>
5019                                
5020    
5021    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5022                                    </p>
5023    <blockquote class="text">
5024    <p>when a new effect send could not be added, i.e.
5025                                        due to invalid parameters
5026    </p>
5027    </blockquote>
5028                                
5029    
5030    </blockquote><p>
5031                        
5032    </p>
5033    <p>Examples:
5034    </p>
5035    <p>
5036                            </p>
5037    <blockquote class="text">
5038    <p>C: "CREATE FX_SEND 0 91 'Reverb Send'"
5039    </p>
5040    <p>S: "OK[0]"
5041    </p>
5042    </blockquote><p>
5043                        
5044    </p>
5045    <p>
5046                            </p>
5047    <blockquote class="text">
5048    <p>C: "CREATE FX_SEND 0 93"
5049    </p>
5050    <p>S: "OK[1]"
5051    </p>
5052    </blockquote><p>
5053                        
5054    </p>
5055    <a name="DESTROY FX_SEND"></a><br /><hr />
5056    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5057    <a name="rfc.section.6.4.26"></a><h3>6.4.26.&nbsp;
5058    Removing an effect send from a sampler channel</h3>
5059    
5060    <p>The front-end can remove an existing effect send on a specific sampler channel
5061                        by sending the following command:
5062    </p>
5063    <p>
5064                            </p>
5065    <blockquote class="text">
5066    <p>DESTROY FX_SEND &lt;sampler-channel&gt; &lt;fx-send-id&gt;
5067    </p>
5068    </blockquote><p>
5069                        
5070    </p>
5071    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
5072                        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>
5073                        or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command, that is the
5074                        sampler channel from which the effect send should be removed from and
5075                        &lt;fx-send-id&gt; is the respective effect send number as returned by the
5076                        <a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>
5077                        or <a class='info' href='#LIST FX_SENDS'>"LIST FX_SENDS"<span> (</span><span class='info'>Listing all effect sends on a sampler channel</span><span>)</span></a> command.
5078    </p>
5079    <p>Possible Answers:
5080    </p>
5081    <p>
5082                            </p>
5083    <blockquote class="text">
5084    <p>"OK" -
5085                                    </p>
5086    <blockquote class="text">
5087    <p>on success
5088    </p>
5089    </blockquote>
5090                                
5091    
5092    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5093                                    </p>
5094    <blockquote class="text">
5095    <p>in case it failed, providing an appropriate error code and
5096                                        error message
5097    </p>
5098    </blockquote>
5099                                
5100    
5101    </blockquote><p>
5102                        
5103    </p>
5104    <p>Example:
5105    </p>
5106    <p>
5107                            </p>
5108    <blockquote class="text">
5109    <p>C: "DESTROY FX_SEND 0 0"
5110    </p>
5111    <p>S: "OK"
5112    </p>
5113    </blockquote><p>
5114                        
5115    </p>
5116    <a name="GET FX_SENDS"></a><br /><hr />
5117    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5118    <a name="rfc.section.6.4.27"></a><h3>6.4.27.&nbsp;
5119    Getting amount of effect sends on a sampler channel</h3>
5120    
5121    <p>The front-end can ask for the amount of effect sends on a specific sampler channel
5122                        by sending the following command:
5123    </p>
5124    <p>
5125                            </p>
5126    <blockquote class="text">
5127    <p>GET FX_SENDS &lt;sampler-channel&gt;
5128    </p>
5129    </blockquote><p>
5130                        
5131    </p>
5132    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
5133                        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>
5134                        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.
5135    </p>
5136    <p>Possible Answers:
5137    </p>
5138    <p>
5139                            </p>
5140    <blockquote class="text">
5141    <p>The sampler will answer by returning the number of effect
5142                                sends on the given sampler channel.
5143    </p>
5144    </blockquote><p>
5145                        
5146    </p>
5147    <p>Example:
5148    </p>
5149    <p>
5150                            </p>
5151    <blockquote class="text">
5152    <p>C: "GET FX_SENDS 0"
5153    </p>
5154    <p>S: "2"
5155    </p>
5156    </blockquote><p>
5157                        
5158    </p>
5159    <a name="LIST FX_SENDS"></a><br /><hr />
5160    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5161    <a name="rfc.section.6.4.28"></a><h3>6.4.28.&nbsp;
5162    Listing all effect sends on a sampler channel</h3>
5163    
5164    <p>The front-end can ask for a list of effect sends on a specific sampler channel
5165                        by sending the following command:
5166    </p>
5167    <p>
5168                            </p>
5169    <blockquote class="text">
5170    <p>LIST FX_SENDS &lt;sampler-channel&gt;
5171    </p>
5172    </blockquote><p>
5173                        
5174    </p>
5175    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
5176                        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>
5177                        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.
5178    </p>
5179    <p>Possible Answers:
5180    </p>
5181    <p>
5182                            </p>
5183    <blockquote class="text">
5184    <p>The sampler will answer by returning a comma separated list
5185                                with all effect sends' numerical IDs on the given sampler
5186                                channel.
5187    </p>
5188    </blockquote><p>
5189                        
5190    </p>
5191    <p>Examples:
5192    </p>
5193    <p>
5194                            </p>
5195    <blockquote class="text">
5196    <p>C: "LIST FX_SENDS 0"
5197    </p>
5198    <p>S: "0,1"
5199    </p>
5200    </blockquote><p>
5201                        
5202    </p>
5203    <p>
5204                            </p>
5205    <blockquote class="text">
5206    <p>C: "LIST FX_SENDS 1"
5207    </p>
5208    <p>S: ""
5209    </p>
5210    </blockquote><p>
5211                        
5212    </p>
5213    <a name="GET FX_SEND INFO"></a><br /><hr />
5214    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5215    <a name="rfc.section.6.4.29"></a><h3>6.4.29.&nbsp;
5216    Getting effect send information</h3>
5217    
5218    <p>The front-end can ask for the current settings of an effect send entity
5219                        by sending the following command:
5220    </p>
5221    <p>
5222                            </p>
5223    <blockquote class="text">
5224    <p>GET FX_SEND INFO &lt;sampler-channel&gt; &lt;fx-send-id&gt;
5225    </p>
5226    </blockquote><p>
5227                        
5228    </p>
5229    <p>Where &lt;sampler-channel&gt; is the sampler channel number
5230                        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>
5231                        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
5232                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5233                        as returned by the <a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>
5234                        or <a class='info' href='#LIST FX_SENDS'>"LIST FX_SENDS"<span> (</span><span class='info'>Listing all effect sends on a sampler channel</span><span>)</span></a> command.
5235                      
5236    </p>
5237    <p>Possible Answers:
5238    </p>
5239    <p>
5240                            </p>
5241    <blockquote class="text">
5242    <p>The sampler will answer by sending a &lt;CRLF&gt; separated list.
5243                                Each answer line begins with the settings category name
5244                                followed by a colon and then a space character &lt;SP&gt; and finally
5245                                the info character string to that setting category. At the
5246                                moment the following categories are defined:
5247    </p>
5248    <p>
5249                                    </p>
5250    <blockquote class="text">
5251    <p>NAME -
5252                                            </p>
5253    <blockquote class="text">
5254    <p>name of the effect send entity
5255    </p>
5256    </blockquote>
5257                                        
5258    
5259    <p>AUDIO_OUTPUT_ROUTING -
5260                                            </p>
5261    <blockquote class="text">
5262    <p>comma separated list which reflects to which audio
5263                                                channel of the selected audio output device each
5264                                                effect send output channel is routed to, e.g. "0,3" would
5265                                                mean the effect send's output channel 0 is routed to channel
5266                                                0 of the audio output device and the effect send's output
5267                                                channel 1 is routed to the channel 3 of the audio
5268                                                output device (see
5269                                                <a class='info' href='#SET FX_SEND AUDIO_OUTPUT_CHANNEL'>"SET FX_SEND AUDIO_OUTPUT_CHANNEL"<span> (</span><span class='info'>Altering effect send's audio routing</span><span>)</span></a>
5270                                                for details)
5271    </p>
5272    </blockquote>
5273                                        
5274    
5275    </blockquote>
5276                                
5277    
5278    </blockquote><p>
5279                        
5280    </p>
5281    <p>The mentioned fields above don't have to be in particular order.
5282    </p>
5283    <p>Example:
5284    </p>
5285    <p>
5286                            </p>
5287    <blockquote class="text">
5288    <p>C: "GET FX_SEND INFO 0 0"
5289    </p>
5290    <p>S: "NAME: Reverb Send"
5291    </p>
5292    <p>&nbsp;&nbsp;&nbsp;"AUDIO_OUTPUT_ROUTING: 2,3"
5293    </p>
5294    <p>&nbsp;&nbsp;&nbsp;"."
5295    </p>
5296    </blockquote><p>
5297                        
5298    </p>
5299    <a name="SET FX_SEND AUDIO_OUTPUT_CHANNEL"></a><br /><hr />
5300    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5301    <a name="rfc.section.6.4.30"></a><h3>6.4.30.&nbsp;
5302    Altering effect send's audio routing</h3>
5303    
5304    <p>The front-end can alter the destination of an effect send's audio channel on a specific
5305                        sampler channel by sending the following command:
5306    </p>
5307    <p>
5308                            </p>
5309    <blockquote class="text">
5310    <p>SET FX_SEND AUDIO_OUTPUT_CHANNEL &lt;sampler-chan&gt; &lt;fx-send-id&gt; &lt;audio-src&gt; &lt;audio-dst&gt;
5311    </p>
5312    </blockquote><p>
5313                        
5314    </p>
5315    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5316                        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>
5317                        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,
5318                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5319                        as returned by the <a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>
5320                        or <a class='info' href='#LIST FX_SENDS'>"LIST FX_SENDS"<span> (</span><span class='info'>Listing all effect sends on a sampler channel</span><span>)</span></a> command,
5321                        &lt;audio-src&gt; is the numerical ID of the effect send's audio channel
5322                        which should be rerouted and &lt;audio-dst&gt; is the numerical ID of
5323                        the audio channel of the selected audio output device where &lt;audio-src&gt;
5324                        should be routed to.
5325    </p>
5326    <p>Note that effect sends can only route audio to the same audio output
5327                        device as assigned to the effect send's sampler channel. Also note that an
5328                        effect send entity does always have exactly as much audio channels as its
5329                        sampler channel. So if the sampler channel is stereo, the effect send does
5330                        have two audio channels as well. Also keep in mind that the amount of audio
5331                        channels on a sampler channel might be dependant not only to the deployed
5332                        sampler engine on the sampler channel, but also dependant to the instrument
5333                        currently loaded. However you can (effectively) turn an i.e. stereo effect
5334                        send into a mono one by simply altering its audio routing appropriately.
5335    </p>
5336    <p>Possible Answers:
5337    </p>
5338    <p>
5339                            </p>
5340    <blockquote class="text">
5341    <p>"OK" -
5342                                    </p>
5343    <blockquote class="text">
5344    <p>on success
5345    </p>
5346    </blockquote>
5347                                
5348    
5349    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5350                                    </p>
5351    <blockquote class="text">
5352    <p>if audio output channel was set, but there are noteworthy
5353                                        issue(s) related, providing an appropriate warning code and
5354                                        warning message
5355    </p>
5356    </blockquote>
5357                                
5358    
5359    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5360                                    </p>
5361    <blockquote class="text">
5362    <p>in case it failed, providing an appropriate error code and error message
5363    </p>
5364    </blockquote>
5365                                
5366    
5367    </blockquote><p>
5368                        
5369    </p>
5370    <p>Example:
5371    </p>
5372    <p>
5373                            </p>
5374    <blockquote class="text">
5375    <p>C: "SET FX_SEND AUDIO_OUTPUT_CHANNEL 0 0 0 2"
5376    </p>
5377    <p>S: "OK"
5378    </p>
5379    </blockquote><p>
5380                        
5381    </p>
5382  <a name="RESET CHANNEL"></a><br /><hr />  <a name="RESET CHANNEL"></a><br /><hr />
5383  <table summary="layout" 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>
5384  <a name="rfc.section.6.4.24"></a><h3>6.4.24.&nbsp;Resetting a sampler channel</h3>  <a name="rfc.section.6.4.31"></a><h3>6.4.31.&nbsp;
5385    Resetting a sampler channel</h3>
5386    
5387  <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:
5388  </p>  </p>
# Line 4786  Intellectual Property and Copyright Stat Line 5446  Intellectual Property and Copyright Stat
5446                                            
5447  </p>  </p>
5448  <a name="anchor12"></a><br /><hr />  <a name="anchor12"></a><br /><hr />
5449  <table summary="layout" 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>
5450  <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;
5451    Controlling connection</h3>
5452    
5453  <p>The following commands are used to control the connection to LinuxSampler.  <p>The following commands are used to control the connection to LinuxSampler.
5454  </p>  </p>
5455  <a name="SUBSCRIBE"></a><br /><hr />  <a name="SUBSCRIBE"></a><br /><hr />
5456  <table summary="layout" 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>
5457  <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;
5458    Register front-end for receiving event messages</h3>
5459    
5460  <p>The front-end can register itself to the LinuxSampler application to  <p>The front-end can register itself to the LinuxSampler application to
5461                      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 5517  Intellectual Property and Copyright Stat
5517                                            
5518  </p>  </p>
5519  <a name="UNSUBSCRIBE"></a><br /><hr />  <a name="UNSUBSCRIBE"></a><br /><hr />
5520  <table summary="layout" 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>
5521  <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;
5522    Unregister front-end for not receiving event messages</h3>
5523    
5524  <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
5525                      messages anymore by sending the following command:                      messages anymore by sending the following command:
# Line 4918  Intellectual Property and Copyright Stat Line 5581  Intellectual Property and Copyright Stat
5581                                            
5582  </p>  </p>
5583  <a name="SET ECHO"></a><br /><hr />  <a name="SET ECHO"></a><br /><hr />
5584  <table summary="layout" 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>
5585  <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;
5586    Enable or disable echo of commands</h3>
5587    
5588  <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:
5589  </p>  </p>
# Line 4974  Intellectual Property and Copyright Stat Line 5638  Intellectual Property and Copyright Stat
5638                                            
5639  </p>  </p>
5640  <a name="QUIT"></a><br /><hr />  <a name="QUIT"></a><br /><hr />
5641  <table summary="layout" 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>
5642  <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;
5643    Close client connection</h3>
5644    
5645  <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:
5646  </p>  </p>
# Line 4991  Intellectual Property and Copyright Stat Line 5656  Intellectual Property and Copyright Stat
5656                      LinuxSampler than really useful for a front-end implementation.                      LinuxSampler than really useful for a front-end implementation.
5657  </p>  </p>
5658  <a name="anchor13"></a><br /><hr />  <a name="anchor13"></a><br /><hr />
5659  <table summary="layout" 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>
5660  <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;
5661    Global commands</h3>
5662    
5663  <p>The following commands have global impact on the sampler.  <p>The following commands have global impact on the sampler.
5664  </p>  </p>
5665  <a name="GET TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="GET TOTAL_VOICE_COUNT"></a><br /><hr />
5666  <table summary="layout" 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>
5667  <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;
5668    Current number of active voices</h3>
5669    
5670  <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
5671                      the sampler by sending the following command:                      the sampler by sending the following command:
# Line 5023  Intellectual Property and Copyright Stat Line 5690  Intellectual Property and Copyright Stat
5690                                            
5691  </p>  </p>
5692  <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />  <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />
5693  <table summary="layout" 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>
5694  <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;
5695    Maximum amount of active voices</h3>
5696    
5697  <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
5698                      by sending the following command:                      by sending the following command:
# Line 5049  Intellectual Property and Copyright Stat Line 5717  Intellectual Property and Copyright Stat
5717                                            
5718  </p>  </p>
5719  <a name="RESET"></a><br /><hr />  <a name="RESET"></a><br /><hr />
5720  <table summary="layout" 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>
5721  <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;
5722    Reset sampler</h3>
5723    
5724  <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:
5725  </p>  </p>
# Line 5089  Intellectual Property and Copyright Stat Line 5758  Intellectual Property and Copyright Stat
5758                                            
5759  </p>  </p>
5760  <a name="GET SERVER INFO"></a><br /><hr />  <a name="GET SERVER INFO"></a><br /><hr />
5761  <table summary="layout" 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>
5762  <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;
5763    General sampler informations</h3>
5764    
5765  <p>The client can ask for general informations about the LinuxSampler  <p>The client can ask for general informations about the LinuxSampler
5766                         instance by sending the following command:                         instance by sending the following command:
# Line 5138  Intellectual Property and Copyright Stat Line 5808  Intellectual Property and Copyright Stat
5808                                          </p>                                          </p>
5809  <blockquote class="text">  <blockquote class="text">
5810  <p>version of the LSCP specification the sampler  <p>version of the LSCP specification the sampler
5811                                              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)
5812  </p>  </p>
5813  </blockquote>  </blockquote>
5814                                                                            
# Line 5152  Intellectual Property and Copyright Stat Line 5822  Intellectual Property and Copyright Stat
5822  <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.
5823                      Other fields might be added in future.                      Other fields might be added in future.
5824  </p>  </p>
5825  <a name="anchor14"></a><br /><hr />  <a name="MIDI Instrument Mapping"></a><br /><hr />
5826  <table summary="layout" 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>
5827  <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;
5828    MIDI Instrument Mapping</h3>
5829    
5830  <p>The MIDI protocol provides a way to switch between instruments  <p>The MIDI protocol provides a way to switch between instruments
5831                  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 5833  Intellectual Property and Copyright Stat
5833                  allow to actually map arbitrary MIDI bank select / program change                  allow to actually map arbitrary MIDI bank select / program change
5834                  numbers with real instruments.                  numbers with real instruments.
5835  </p>  </p>
5836  <p>By default, that is when the sampler is launched, this map will  <p>The sampler allows to manage an arbitrary amount of MIDI
5837                  be empty, thus the sampler will simply ignore all program change                  instrument maps which define which instrument to load on
5838                  messages. The front-end has to explicitly add entries to the map                  which MIDI program change message.
5839                  so the sampler knows how to react on a given program change  </p>
5840                  message, that is by switching to the respectively defined engine  <p>By default, that is when the sampler is launched, there is no
5841                  type and loading the respective instrument.                  map, thus the sampler will simply ignore all program change
5842                    messages. The front-end has to explicitly create at least one
5843                    map, add entries to the map and tell the respective sampler
5844                    channel(s) which MIDI instrument map to use, so the sampler
5845                    knows how to react on a given program change message on the
5846                    respective sampler channel, that is by switching to the
5847                    respectively defined engine type and loading the respective
5848                    instrument. See command
5849                    <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>
5850                    for how to assign a MIDI instrument map to a sampler channel.
5851  </p>  </p>
5852  <p>Also note per MIDI specification a bank select message does not  <p>Also note per MIDI specification a bank select message does not
5853                  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 5856  Intellectual Property and Copyright Stat
5856                  cause the sampler to switch to the respective instrument as                  cause the sampler to switch to the respective instrument as
5857                  reflected by the current MIDI instrument map.                  reflected by the current MIDI instrument map.
5858  </p>  </p>
5859    <a name="ADD MIDI_INSTRUMENT MAP"></a><br /><hr />
5860    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5861    <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;
5862    Create a new MIDI instrument map</h3>
5863    
5864    <p>The front-end can add a new MIDI instrument map by sending
5865                        the following command:
5866    </p>
5867    <p>
5868                            </p>
5869    <blockquote class="text">
5870    <p>ADD MIDI_INSTRUMENT_MAP [&lt;name&gt;]
5871    </p>
5872    </blockquote><p>
5873                        
5874    </p>
5875    <p>Where &lt;name&gt; is an optional argument allowing to
5876                        assign a custom name to the new map. MIDI instrument Map
5877                        names do not have to be unique.
5878    </p>
5879    <p>Possible Answers:
5880    </p>
5881    <p>
5882                            </p>
5883    <blockquote class="text">
5884    <p>"OK[&lt;map&gt;]" -
5885                                    </p>
5886    <blockquote class="text">
5887    <p>in case a new MIDI instrument map could
5888                                        be added, where &lt;map&gt; reflects the
5889                                        unique ID of the newly created MIDI
5890                                        instrument map
5891    </p>
5892    </blockquote>
5893                                
5894    
5895    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5896                                    </p>
5897    <blockquote class="text">
5898    <p>when a new map could not be created, which
5899                                        might never occur in practice
5900    </p>
5901    </blockquote>
5902                                
5903    
5904    </blockquote><p>
5905                        
5906    </p>
5907    <p>Examples:
5908    </p>
5909    <p>
5910                            </p>
5911    <blockquote class="text">
5912    <p>C: "ADD MIDI_INSTRUMENT_MAP 'Standard Map'"
5913    </p>
5914    <p>S: "OK[0]"
5915    </p>
5916    </blockquote><p>
5917                        
5918    </p>
5919    <p>
5920                            </p>
5921    <blockquote class="text">
5922    <p>C: "ADD MIDI_INSTRUMENT_MAP 'Standard Drumkit'"
5923    </p>
5924    <p>S: "OK[1]"
5925    </p>
5926    </blockquote><p>
5927                        
5928    </p>
5929    <p>
5930                            </p>
5931    <blockquote class="text">
5932    <p>C: "ADD MIDI_INSTRUMENT_MAP"
5933    </p>
5934    <p>S: "OK[5]"
5935    </p>
5936    </blockquote><p>
5937                        
5938    </p>
5939    <a name="REMOVE MIDI_INSTRUMENT_MAP"></a><br /><hr />
5940    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
5941    <a name="rfc.section.6.7.2"></a><h3>6.7.2.&nbsp;
5942    Delete one particular or all MIDI instrument maps</h3>
5943    
5944    <p>The front-end can delete a particular MIDI instrument map
5945                        by sending the following command:
5946    </p>
5947    <p>
5948                            </p>
5949    <blockquote class="text">
5950    <p>REMOVE MIDI_INSTRUMENT_MAP &lt;map&gt;
5951    </p>
5952    </blockquote><p>
5953                        
5954    </p>
5955    <p>Where &lt;map&gt; reflects the unique ID of the map to delete
5956                        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>
5957                        command.
5958    </p>
5959    <p>The front-end can delete all MIDI instrument maps by
5960                        sending the following command:
5961    </p>
5962    <p>
5963                            </p>
5964    <blockquote class="text">
5965    <p>REMOVE MIDI_INSTRUMENT_MAP ALL
5966    </p>
5967    </blockquote><p>
5968                        
5969    </p>
5970    <p>Possible Answers:
5971    </p>
5972    <p>
5973                            </p>
5974    <blockquote class="text">
5975    <p>"OK" -
5976                                    </p>
5977    <blockquote class="text">
5978    <p>in case the map(s) could be deleted
5979    </p>
5980    </blockquote>
5981                                
5982    
5983    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5984                                    </p>
5985    <blockquote class="text">
5986    <p>when the given map does not exist
5987    </p>
5988    </blockquote>
5989                                
5990    
5991    </blockquote><p>
5992                        
5993    </p>
5994    <p>Examples:
5995    </p>
5996    <p>
5997                            </p>
5998    <blockquote class="text">
5999    <p>C: "REMOVE MIDI_INSTRUMENT_MAP 0"
6000    </p>
6001    <p>S: "OK"
6002    </p>
6003    </blockquote><p>
6004                        
6005    </p>
6006    <p>
6007                            </p>
6008    <blockquote class="text">
6009    <p>C: "REMOVE MIDI_INSTRUMENT_MAP ALL"
6010    </p>
6011    <p>S: "OK"
6012    </p>
6013    </blockquote><p>
6014                        
6015    </p>
6016    <a name="GET MIDI_INSTRUMENT_MAPS"></a><br /><hr />
6017    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6018    <a name="rfc.section.6.7.3"></a><h3>6.7.3.&nbsp;
6019    Get amount of existing MIDI instrument maps</h3>
6020    
6021    <p>The front-end can retrieve the current amount of MIDI
6022                        instrument maps by sending the following command:
6023    </p>
6024    <p>
6025                            </p>
6026    <blockquote class="text">
6027    <p>GET MIDI_INSTRUMENT_MAPS
6028    </p>
6029    </blockquote><p>
6030                        
6031    </p>
6032    <p>Possible Answers:
6033    </p>
6034    <p>
6035                            </p>
6036    <blockquote class="text">
6037    <p>The sampler will answer by returning the current
6038                                number of MIDI instrument maps.
6039    </p>
6040    </blockquote><p>
6041                        
6042    </p>
6043    <p>Example:
6044    </p>
6045    <p>
6046                            </p>
6047    <blockquote class="text">
6048    <p>C: "GET MIDI_INSTRUMENT_MAPS"
6049    </p>
6050    <p>S: "2"
6051    </p>
6052    </blockquote><p>
6053                        
6054    </p>
6055    <a name="LIST MIDI_INSTRUMENT_MAPS"></a><br /><hr />
6056    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6057    <a name="rfc.section.6.7.4"></a><h3>6.7.4.&nbsp;
6058    Getting all created MIDI instrument maps</h3>
6059    
6060    <p>The number of MIDI instrument maps can change on runtime. To get the
6061                        current list of MIDI instrument maps, the front-end can send the
6062                        following command:
6063    </p>
6064    <p>
6065                            </p>
6066    <blockquote class="text">
6067    <p>LIST MIDI_INSTRUMENT_MAPS
6068    </p>
6069    </blockquote><p>
6070                        
6071    </p>
6072    <p>Possible Answers:
6073    </p>
6074    <p>
6075                            </p>
6076    <blockquote class="text">
6077    <p>The sampler will answer by returning a comma separated list
6078                                with all MIDI instrument maps' numerical IDs.
6079    </p>
6080    </blockquote><p>
6081                        
6082    </p>
6083    <p>Example:
6084    </p>
6085    <p>
6086                            </p>
6087    <blockquote class="text">
6088    <p>C: "LIST MIDI_INSTRUMENT_MAPS"
6089    </p>
6090    <p>S: "0,1,5,12"
6091    </p>
6092    </blockquote><p>
6093                        
6094    </p>
6095    <a name="GET MIDI_INSTRUMENT_MAP INFO"></a><br /><hr />
6096    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6097    <a name="rfc.section.6.7.5"></a><h3>6.7.5.&nbsp;
6098    Getting MIDI instrument map information</h3>
6099    
6100    <p>The front-end can ask for the current settings of a MIDI
6101                        instrument map by sending the following command:
6102    </p>
6103    <p>
6104                            </p>
6105    <blockquote class="text">
6106    <p>GET MIDI_INSTRUMENT_MAP INFO &lt;map&gt;
6107    </p>
6108    </blockquote><p>
6109                        
6110    </p>
6111    <p>Where &lt;map&gt; is the numerical ID of the map the
6112                        front-end is interested in as returned by the
6113                        <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>
6114                        command.
6115    </p>
6116    <p>Possible Answers:
6117    </p>
6118    <p>
6119                            </p>
6120    <blockquote class="text">
6121    <p>LinuxSampler will answer by sending a &lt;CRLF&gt; separated list.
6122                                Each answer line begins with the settings category name
6123                                followed by a colon and then a space character &lt;SP&gt; and finally
6124                                the info character string to that setting category. At the
6125                                moment the following categories are defined:
6126    </p>
6127    <p>
6128                                    </p>
6129    <blockquote class="text">
6130    <p>NAME -
6131                                            </p>
6132    <blockquote class="text">
6133    <p>custom name of the given map,
6134                                                which does not have to be unique
6135    </p>
6136    </blockquote>
6137                                        
6138    
6139    </blockquote>
6140                                
6141    
6142    </blockquote><p>
6143                        
6144    </p>
6145    <p>The mentioned fields above don't have to be in particular order.
6146    </p>
6147    <p>Example:
6148    </p>
6149    <p>
6150                            </p>
6151    <blockquote class="text">
6152    <p>C: "GET MIDI_INSTRUMENT_MAP INFO 0"
6153    </p>
6154    <p>S: "NAME: Standard Map"
6155    </p>
6156    <p>&nbsp;&nbsp;&nbsp;"."
6157    </p>
6158    </blockquote><p>
6159                        
6160    </p>
6161    <a name="SET MIDI_INSTRUMENT_MAP NAME"></a><br /><hr />
6162    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
6163    <a name="rfc.section.6.7.6"></a><h3>6.7.6.&nbsp;
6164    Renaming a MIDI instrument map</h3>
6165    
6166    <p>The front-end can alter the custom name of a MIDI
6167                        instrument map by sending the following command:
6168    </p>
6169    <p>
6170                            </p>
6171    <blockquote class="text">
6172    <p>SET MIDI_INSTRUMENT_MAP NAME &lt;map&gt; &lt;name&gt;
6173    </p>
6174    </blockquote><p>
6175                        
6176    </p>
6177    <p>Where &lt;map&gt; is the numerical ID of the map and
6178                        &lt;name&gt; the new custom name of the map, which does not
6179                        have to be unique.
6180    </p>
6181    <p>Possible Answers:
6182    </p>
6183    <p>
6184                            </p>
6185    <blockquote class="text">
6186    <p>"OK" -
6187                                    </p>
6188    <blockquote class="text">
6189    <p>on success
6190    </p>
6191    </blockquote>
6192                                
6193    
6194    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
6195                                    </p>
6196    <blockquote class="text">
6197    <p>in case the given map does not exist
6198    </p>
6199    </blockquote>
6200                                
6201    
6202    </blockquote><p>
6203                        
6204    </p>
6205    <p>Example:
6206    </p>
6207    <p>
6208                            </p>
6209    <blockquote class="text">
6210    <p>C: "SET MIDI_INSTRUMENT_MAP NAME 0 'Foo instruments'"
6211    </p>
6212    <p>S: "OK"
6213    </p>
6214    </blockquote><p>
6215                        
6216    </p>
6217  <a name="MAP MIDI_INSTRUMENT"></a><br /><hr />  <a name="MAP MIDI_INSTRUMENT"></a><br /><hr />
6218  <table summary="layout" 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>
6219  <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;
6220    Create or replace a MIDI instrument map entry</h3>
6221    
6222  <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
6223                      in the sampler's MIDI instrument map by sending the following                      in a sampler's MIDI instrument map by sending the following
6224                      command:                      command:
6225  </p>  </p>
6226  <p>  <p>
6227                          </p>                          </p>
6228  <blockquote class="text">  <blockquote class="text">
6229  <p>MAP MIDI_INSTRUMENT &lt;midi_bank_msb&gt;  <p>MAP MIDI_INSTRUMENT &lt;map&gt;
6230                              &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;
6231                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;
6232                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]
6233  </p>  </p>
6234  </blockquote><p>  </blockquote><p>
6235                                            
6236  </p>  </p>
6237  <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,
6238                      0..127 reflecting the MIDI bank select MSB (coarse) index,                      &lt;midi_bank&gt; is an integer value between
6239                      &lt;midi_bank_lsb&gt; an integer value between 0..127 reflecting                      0..16383 reflecting the MIDI bank select index,
6240                      the MIDI bank select LSB (fine) index, &lt;midi_prog&gt; an                      &lt;midi_prog&gt; an
6241                      integer value between 0..127 reflecting the MIDI program change                      integer value between 0..127 reflecting the MIDI program change
6242                      index, &lt;engine_name&gt; a sampler engine name as returned by                      index, &lt;engine_name&gt; a sampler engine name as returned by
6243                      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>
6244                      command (not encapsulated into apostrophes), &lt;filename&gt; the name                      command (not encapsulated into apostrophes), &lt;filename&gt; the name
6245                      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),
6246                        &lt;instrument_index&gt; the index (integer value) of the instrument
6247                      within the given file, &lt;volume_value&gt; reflects the master                      within the given file, &lt;volume_value&gt; reflects the master
6248                      volume of the instrument as optionally dotted number (where a                      volume of the instrument as optionally dotted number (where a
6249                      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 6338  Intellectual Property and Copyright Stat
6338                      individually. Due to this, in case the frontend shows the                      individually. Due to this, in case the frontend shows the
6339                      load modes of entries, the frontend should retrieve the actual                      load modes of entries, the frontend should retrieve the actual
6340                      mode by i.e. sending                      mode by i.e. sending
6341                      <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>
6342                      command(s). Finally the OPTIONAL &lt;name&gt; argument allows to                      command(s). Finally the OPTIONAL &lt;name&gt; argument allows to
6343                      set a custom name (encapsulated into apostrophes) for the mapping                      set a custom name (encapsulated into apostrophes) for the mapping
6344                      entry, useful for frontends for displaying an appropriate name for                      entry, useful for frontends for displaying an appropriate name for
6345                      mapped instruments (using                      mapped instruments (using
6346                      <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>).
6347                                            
6348  </p>  </p>
6349  <p>  <p>
# Line 5332  Intellectual Property and Copyright Stat Line 6372  Intellectual Property and Copyright Stat
6372  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
6373                                  </p>                                  </p>
6374  <blockquote class="text">  <blockquote class="text">
6375  <p>when the given engine does not exist or a value  <p>when the given map or engine does not exist or a value
6376                                      is out of range                                      is out of range
6377  </p>  </p>
6378  </blockquote>  </blockquote>
# Line 5346  Intellectual Property and Copyright Stat Line 6386  Intellectual Property and Copyright Stat
6386  <p>  <p>
6387                          </p>                          </p>
6388  <blockquote class="text">  <blockquote class="text">
6389  <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"
6390  </p>  </p>
6391  <p>S: "OK"  <p>S: "OK"
6392  </p>  </p>
# Line 5356  Intellectual Property and Copyright Stat Line 6396  Intellectual Property and Copyright Stat
6396  <p>  <p>
6397                          </p>                          </p>
6398  <blockquote class="text">  <blockquote class="text">
6399  <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"
6400  </p>  </p>
6401  <p>S: "OK"  <p>S: "OK"
6402  </p>  </p>
# Line 5370  Intellectual Property and Copyright Stat Line 6410  Intellectual Property and Copyright Stat
6410  </p>  </p>
6411  <p>S: "OK"  <p>S: "OK"
6412  </p>  </p>
6413  <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'"
6414  </p>  </p>
6415  <p>S: "OK"  <p>S: "OK"
6416  </p>  </p>
# Line 5380  Intellectual Property and Copyright Stat Line 6420  Intellectual Property and Copyright Stat
6420  <p>  <p>
6421                          </p>                          </p>
6422  <blockquote class="text">  <blockquote class="text">
6423  <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'"
6424  </p>  </p>
6425  <p>S: "OK"  <p>S: "OK"
6426  </p>  </p>
# Line 5388  Intellectual Property and Copyright Stat Line 6428  Intellectual Property and Copyright Stat
6428                                            
6429  </p>  </p>
6430  <a name="GET MIDI_INSTRUMENTS"></a><br /><hr />  <a name="GET MIDI_INSTRUMENTS"></a><br /><hr />
6431  <table summary="layout" 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>
6432  <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;
6433    Getting ammount of MIDI instrument map entries</h3>
6434    
6435  <p>The front-end can query the amount of currently existing MIDI  <p>The front-end can query the amount of currently existing
6436                      instrument map entries by sending the following                      entries in a MIDI instrument map by sending the following
6437                        command:
6438    </p>
6439    <p>
6440                            </p>
6441    <blockquote class="text">
6442    <p>GET MIDI_INSTRUMENTS &lt;map&gt;
6443    </p>
6444    </blockquote><p>
6445                        
6446    </p>
6447    <p>The front-end can query the amount of currently existing
6448                        entries in all MIDI instrument maps by sending the following
6449                      command:                      command:
6450  </p>  </p>
6451  <p>  <p>
6452                          </p>                          </p>
6453  <blockquote class="text">  <blockquote class="text">
6454  <p>GET MIDI_INSTRUMENTS  <p>GET MIDI_INSTRUMENTS ALL
6455  </p>  </p>
6456  </blockquote><p>  </blockquote><p>
6457                                            
# Line 5408  Intellectual Property and Copyright Stat Line 6461  Intellectual Property and Copyright Stat
6461  <p>  <p>
6462                          </p>                          </p>
6463  <blockquote class="text">  <blockquote class="text">
6464  <p>LinuxSampler will answer by sending the current number of  <p>The sampler will answer by sending the current number of
6465                              entries in the sampler's MIDI instrument map.                              entries in the MIDI instrument map(s).
6466  </p>  </p>
6467  </blockquote><p>  </blockquote><p>
6468                                            
# Line 5419  Intellectual Property and Copyright Stat Line 6472  Intellectual Property and Copyright Stat
6472  <p>  <p>
6473                          </p>                          </p>
6474  <blockquote class="text">  <blockquote class="text">
6475  <p>C: "GET MIDI_INSTRUMENTS"  <p>C: "GET MIDI_INSTRUMENTS 0"
6476  </p>  </p>
6477  <p>S: "634"  <p>S: "234"
6478    </p>
6479    </blockquote><p>
6480                        
6481    </p>
6482    <p>
6483                            </p>
6484    <blockquote class="text">
6485    <p>C: "GET MIDI_INSTRUMENTS ALL"
6486    </p>
6487    <p>S: "954"
6488  </p>  </p>
6489  </blockquote><p>  </blockquote><p>
6490                                            
6491  </p>  </p>
6492  <a name="LIST MIDI_INSTRUMENTS"></a><br /><hr />  <a name="LIST MIDI_INSTRUMENTS"></a><br /><hr />
6493  <table summary="layout" 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>
6494  <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;
6495    Getting indeces of all entries of a MIDI instrument map</h3>
6496    
6497  <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
6498                      instrument map entries by sending the following command:                      entries in a certain MIDI instrument map by sending the following
6499                        command:
6500  </p>  </p>
6501  <p>  <p>
6502                          </p>                          </p>
6503  <blockquote class="text">  <blockquote class="text">
6504  <p>LIST MIDI_INSTRUMENTS  <p>LIST MIDI_INSTRUMENTS &lt;map&gt;
6505    </p>
6506    </blockquote><p>
6507                        
6508    </p>
6509    <p>Where &lt;map&gt; is the numeric ID of the MIDI instrument map.
6510    </p>
6511    <p>The front-end can query a list of all currently existing
6512                        entries of all MIDI instrument maps by sending the following
6513                        command:
6514    </p>
6515    <p>
6516                            </p>
6517    <blockquote class="text">
6518    <p>LIST MIDI_INSTRUMENTS ALL
6519  </p>  </p>
6520  </blockquote><p>  </blockquote><p>
6521                                            
# Line 5446  Intellectual Property and Copyright Stat Line 6525  Intellectual Property and Copyright Stat
6525  <p>  <p>
6526                          </p>                          </p>
6527  <blockquote class="text">  <blockquote class="text">
6528  <p>LinuxSampler will answer by sending a comma separated  <p>The sampler will answer by sending a comma separated
6529                              list of MIDI bank MSB (coarse) - MIDI bank LSB (fine) -                              list of map ID - MIDI bank - MIDI program triples, where
6530                              MIDI program triples, where each triple is encapsulated                              each triple is encapsulated into curly braces. The
6531                              into curly braces. The list is returned in one single                              list is returned in one single line. Each triple
6532                              line. Each triple just reflects the key of the respective                              just reflects the key of the respective map entry,
6533                              map entry, thus subsequent                              thus subsequent
6534                              <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>
6535                              command(s) are necessary to retrieve detailed informations                              command(s) are necessary to retrieve detailed informations
6536                              about each entry.                              about each entry.
6537  </p>  </p>
# Line 5464  Intellectual Property and Copyright Stat Line 6543  Intellectual Property and Copyright Stat
6543  <p>  <p>
6544                          </p>                          </p>
6545  <blockquote class="text">  <blockquote class="text">
6546  <p>C: "LIST MIDI_INSTRUMENTS"  <p>C: "LIST MIDI_INSTRUMENTS 0"
6547  </p>  </p>
6548  <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}"
6549  </p>  </p>
6550  </blockquote><p>  </blockquote><p>
6551                                            
6552  </p>  </p>
6553  <a name="UNMAP MIDI_INSTRUMENT"></a><br /><hr />  <a name="UNMAP MIDI_INSTRUMENT"></a><br /><hr />
6554  <table summary="layout" 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>
6555  <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;
6556    Remove an entry from the MIDI instrument map</h3>
6557    
6558  <p>The front-end can delete an entry from the MIDI instrument  <p>The front-end can delete an entry from a MIDI instrument
6559                      map by sending the following command:                      map by sending the following command:
6560  </p>  </p>
6561  <p>  <p>
6562                          </p>                          </p>
6563  <blockquote class="text">  <blockquote class="text">
6564  <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;
6565  </p>  </p>
6566  </blockquote><p>  </blockquote><p>
6567                                            
6568  </p>  </p>
6569  <p>  <p>
6570                      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,
6571                      reflecting the MIDI bank MSB (coarse) value, &lt;midi_bank_lsb&gt;                      &lt;midi_bank&gt; is an integer value between 0..16383
6572                      an integer value between 0..127 reflecting the MIDI bank LSB                      reflecting the MIDI bank value and
6573                      (fine) value and &lt;midi_prog&gt; an integer value between                      &lt;midi_prog&gt; an integer value between
6574                      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
6575                      index triple.                      index triple.
6576                                            
6577  </p>  </p>
# Line 5524  Intellectual Property and Copyright Stat Line 6604  Intellectual Property and Copyright Stat
6604  <p>  <p>
6605                          </p>                          </p>
6606  <blockquote class="text">  <blockquote class="text">
6607  <p>C: "UNMAP MIDI_INSTRUMENT 2 40 127"  <p>C: "UNMAP MIDI_INSTRUMENT 0 2 127"
6608  </p>  </p>
6609  <p>S: "OK"  <p>S: "OK"
6610  </p>  </p>
# Line 5532  Intellectual Property and Copyright Stat Line 6612  Intellectual Property and Copyright Stat
6612                                            
6613  </p>  </p>
6614  <a name="GET MIDI_INSTRUMENT INFO"></a><br /><hr />  <a name="GET MIDI_INSTRUMENT INFO"></a><br /><hr />
6615  <table summary="layout" 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>
6616  <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;
6617    Get current settings of MIDI instrument map entry</h3>
6618    
6619  <p>The front-end can retrieve the current settings of a certain  <p>The front-end can retrieve the current settings of a certain
6620                      instrument map entry by sending the following command:                      instrument map entry by sending the following command:
# Line 5541  Intellectual Property and Copyright Stat Line 6622  Intellectual Property and Copyright Stat
6622  <p>  <p>
6623                          </p>                          </p>
6624  <blockquote class="text">  <blockquote class="text">
6625  <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;
6626  </p>  </p>
6627  </blockquote><p>  </blockquote><p>
6628                                            
6629  </p>  </p>
6630  <p>  <p>
6631                      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,
6632                      reflecting the MIDI bank MSB (coarse) value, &lt;midi_bank_lsb&gt;                      &lt;midi_bank&gt; is an integer value between 0..16383
6633                      an integer value between 0..127 reflecting the MIDI bank LSB                      reflecting the MIDI bank value, &lt;midi_bank&gt;
6634                      (fine) value and &lt;midi_prog&gt; an integer value between                      and &lt;midi_prog&gt; an integer value between
6635                      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
6636                      index triple.                      index triple.
6637                                            
6638  </p>  </p>
# Line 5574  Intellectual Property and Copyright Stat Line 6655  Intellectual Property and Copyright Stat
6655                                      This name shall be used by frontends for displaying a                                      This name shall be used by frontends for displaying a
6656                                      name for this mapped instrument. It can be set and                                      name for this mapped instrument. It can be set and
6657                                      changed with the                                      changed with the
6658                                      <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>
6659                                      command and does not have to be unique.                                      command and does not have to be unique.
6660  </p>  </p>
6661  </blockquote>  </blockquote>
# Line 5619  Intellectual Property and Copyright Stat Line 6700  Intellectual Property and Copyright Stat
6700                                  </p>                                  </p>
6701  <blockquote class="text">  <blockquote class="text">
6702  <p>Life time of instrument  <p>Life time of instrument
6703                                      (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).
6704  </p>  </p>
6705  </blockquote>  </blockquote>
6706                                                            
# Line 5644  Intellectual Property and Copyright Stat Line 6725  Intellectual Property and Copyright Stat
6725  <p>  <p>
6726                          </p>                          </p>
6727  <blockquote class="text">  <blockquote class="text">
6728  <p>C: "GET MIDI_INSTRUMENT INFO 3 45 120"  <p>C: "GET MIDI_INSTRUMENT INFO 1 45 120"
6729  </p>  </p>
6730  <p>S: "NAME: Drums for Foo Song"  <p>S: "NAME: Drums for Foo Song"
6731  </p>  </p>
# Line 5666  Intellectual Property and Copyright Stat Line 6747  Intellectual Property and Copyright Stat
6747                                            
6748  </p>  </p>
6749  <a name="CLEAR MIDI_INSTRUMENTS"></a><br /><hr />  <a name="CLEAR MIDI_INSTRUMENTS"></a><br /><hr />
6750  <table summary="layout" 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>
6751  <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;
6752    Clear MIDI instrument map</h3>
6753    
6754  <p>The front-end can clear the whole MIDI instrument map, that  <p>The front-end can clear a whole MIDI instrument map, that
6755                      is delete all entries by sending the following command:                      is delete all its entries by sending the following command:
6756  </p>  </p>
6757  <p>  <p>
6758                          </p>                          </p>
6759  <blockquote class="text">  <blockquote class="text">
6760  <p>CLEAR MIDI_INSTRUMENTS  <p>CLEAR MIDI_INSTRUMENTS &lt;map&gt;
6761  </p>  </p>
6762  </blockquote><p>  </blockquote><p>
6763                                            
6764  </p>  </p>
6765    <p>Where &lt;map&gt; is the numeric ID of the map to clear.
6766    </p>
6767    <p>The front-end can clear all MIDI instrument maps, that
6768                        is delete all entries of all maps by sending the following
6769                        command:
6770    </p>
6771    <p>
6772                            </p>
6773    <blockquote class="text">
6774    <p>CLEAR MIDI_INSTRUMENTS ALL
6775    </p>
6776    </blockquote><p>
6777                        
6778    </p>
6779    <p>The command "CLEAR MIDI_INSTRUMENTS ALL" does not delete the
6780                        maps, only their entries, thus the map's settings like
6781                        custom name will be preservevd.
6782    </p>
6783  <p>Possible Answers:  <p>Possible Answers:
6784  </p>  </p>
6785  <p>  <p>
# Line 5696  Intellectual Property and Copyright Stat Line 6796  Intellectual Property and Copyright Stat
6796  </blockquote><p>  </blockquote><p>
6797                                            
6798  </p>  </p>
6799  <p>Example:  <p>Examples:
6800  </p>  </p>
6801  <p>  <p>
6802                         </p>                         </p>
6803  <blockquote class="text">  <blockquote class="text">
6804  <p>C: "CLEAR MIDI_INSTRUMENTS"  <p>C: "CLEAR MIDI_INSTRUMENTS 0"
6805    </p>
6806    <p>S: "OK"
6807    </p>
6808    </blockquote><p>
6809                        
6810    </p>
6811    <p>
6812                           </p>
6813    <blockquote class="text">
6814    <p>C: "CLEAR MIDI_INSTRUMENTS ALL"
6815  </p>  </p>
6816  <p>S: "OK"  <p>S: "OK"
6817  </p>  </p>
# Line 5709  Intellectual Property and Copyright Stat Line 6819  Intellectual Property and Copyright Stat
6819                                            
6820  </p>  </p>
6821  <a name="command_syntax"></a><br /><hr />  <a name="command_syntax"></a><br /><hr />
6822  <table summary="layout" 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>
6823  <a name="rfc.section.7"></a><h3>7.&nbsp;Command Syntax</h3>  <a name="rfc.section.7"></a><h3>7.&nbsp;
6824    Command Syntax</h3>
6825    
6826  <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>
6827              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>)
6828              where applicable.              where applicable.
6829                            
6830  </p>  </p>
# Line 5771  Intellectual Property and Copyright Stat Line 6882  Intellectual Property and Copyright Stat
6882  <p>command =  <p>command =
6883          </p>          </p>
6884  <blockquote class="text">  <blockquote class="text">
6885  <p>ADD SP CHANNEL  <p>ADD SP add_instruction
6886                                    
6887  </p>  </p>
6888  <p>/ MAP SP map_instruction  <p>/ MAP SP map_instruction
# Line 5796  Intellectual Property and Copyright Stat Line 6907  Intellectual Property and Copyright Stat
6907                                    
6908  </p>  </p>
6909  <p>/ REMOVE SP remove_instruction  <p>/ REMOVE SP remove_instruction
   
6910                                    
6911  </p>  </p>
6912  <p>/ SET SP set_instruction  <p>/ SET SP set_instruction
# Line 5826  Intellectual Property and Copyright Stat Line 6936  Intellectual Property and Copyright Stat
6936  </blockquote><p>  </blockquote><p>
6937    
6938  </p>  </p>
6939    <p>add_instruction =
6940            </p>
6941    <blockquote class="text">
6942    <p>CHANNEL
6943                    
6944    </p>
6945    <p>/ MIDI_INSTRUMENT_MAP
6946                    
6947    </p>
6948    <p>/ MIDI_INSTRUMENT_MAP SP map_name
6949                    
6950    </p>
6951    </blockquote><p>
6952    
6953    </p>
6954  <p>subscribe_event =  <p>subscribe_event =
6955          </p>          </p>
6956  <blockquote class="text">  <blockquote class="text">
6957  <p>CHANNEL_COUNT  <p>AUDIO_OUTPUT_DEVICE_COUNT
6958                    
6959    </p>
6960    <p>/ AUDIO_OUTPUT_DEVICE_INFO
6961                    
6962    </p>
6963    <p>/ MIDI_INPUT_DEVICE_COUNT
6964                    
6965    </p>
6966    <p>/ MIDI_INPUT_DEVICE_INFO
6967                    
6968    </p>
6969    <p>/ CHANNEL_COUNT
6970                                    
6971  </p>  </p>
6972  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
# Line 5844  Intellectual Property and Copyright Stat Line 6981  Intellectual Property and Copyright Stat
6981  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
6982                                    
6983  </p>  </p>
6984    <p>/ MIDI_INSTRUMENT_MAP_COUNT
6985                    
6986    </p>
6987    <p>/ MIDI_INSTRUMENT_MAP_INFO
6988                    
6989    </p>
6990    <p>/ MIDI_INSTRUMENT_COUNT
6991                    
6992    </p>
6993    <p>/ MIDI_INSTRUMENT_INFO
6994                    
6995    </p>
6996  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
6997                                    
6998  </p>  </p>
# Line 5856  Intellectual Property and Copyright Stat Line 7005  Intellectual Property and Copyright Stat
7005  <p>unsubscribe_event =  <p>unsubscribe_event =
7006          </p>          </p>
7007  <blockquote class="text">  <blockquote class="text">
7008  <p>CHANNEL_COUNT  <p>AUDIO_OUTPUT_DEVICE_COUNT
7009                    
7010    </p>
7011    <p>/ AUDIO_OUTPUT_DEVICE_INFO
7012                    
7013    </p>
7014    <p>/ MIDI_INPUT_DEVICE_COUNT
7015                    
7016    </p>
7017    <p>/ MIDI_INPUT_DEVICE_INFO
7018                    
7019    </p>
7020    <p>/ CHANNEL_COUNT
7021                                    
7022  </p>  </p>
7023  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
# Line 5871  Intellectual Property and Copyright Stat Line 7032  Intellectual Property and Copyright Stat
7032  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
7033                                    
7034  </p>  </p>
7035    <p>/ MIDI_INSTRUMENT_MAP_COUNT
7036                    
7037    </p>
7038    <p>/ MIDI_INSTRUMENT_MAP_INFO
7039                    
7040    </p>
7041    <p>/ MIDI_INSTRUMENT_COUNT
7042                    
7043    </p>
7044    <p>/ MIDI_INSTRUMENT_INFO
7045                    
7046    </p>
7047  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
7048                                    
7049  </p>  </p>
# Line 5883  Intellectual Property and Copyright Stat Line 7056  Intellectual Property and Copyright Stat
7056  <p>map_instruction =  <p>map_instruction =
7057          </p>          </p>
7058  <blockquote class="text">  <blockquote class="text">
7059  <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
7060                                    
7061  </p>  </p>
7062  <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
7063                                    
7064  </p>  </p>
7065  <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
7066                                    
7067  </p>  </p>
7068  <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
7069                                    
7070  </p>  </p>
7071  </blockquote><p>  </blockquote><p>
# Line 5901  Intellectual Property and Copyright Stat Line 7074  Intellectual Property and Copyright Stat
7074  <p>unmap_instruction =  <p>unmap_instruction =
7075          </p>          </p>
7076  <blockquote class="text">  <blockquote class="text">
7077  <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
7078                                    
7079  </p>  </p>
7080  </blockquote><p>  </blockquote><p>
# Line 5913  Intellectual Property and Copyright Stat Line 7086  Intellectual Property and Copyright Stat
7086  <p>CHANNEL SP sampler_channel  <p>CHANNEL SP sampler_channel
7087                                    
7088  </p>  </p>
7089    <p>/ MIDI_INSTRUMENT_MAP SP midi_map
7090                    
7091    </p>
7092    <p>/ MIDI_INSTRUMENT_MAP SP ALL
7093                    
7094    </p>
7095  </blockquote><p>  </blockquote><p>
7096    
7097  </p>  </p>
# Line 5997  Intellectual Property and Copyright Stat Line 7176  Intellectual Property and Copyright Stat
7176  <p>/ TOTAL_VOICE_COUNT_MAX  <p>/ TOTAL_VOICE_COUNT_MAX
7177                                    
7178  </p>  </p>
7179  <p>/ MIDI_INSTRUMENTS  <p>/ MIDI_INSTRUMENTS SP midi_map
7180                    
7181    </p>
7182    <p>/ MIDI_INSTRUMENTS SP ALL
7183                    
7184    </p>
7185    <p>/ MIDI_INSTRUMENT SP INFO SP midi_map SP midi_bank SP midi_prog
7186                    
7187    </p>
7188    <p>/ MIDI_INSTRUMENT_MAPS
7189                    
7190    </p>
7191    <p>/ MIDI_INSTRUMENT_MAP SP INFO SP midi_map
7192                    
7193    </p>
7194    <p>/ FX_SENDS SP sampler_channel
7195                                    
7196  </p>  </p>
7197  <p>/ MIDI_INSTRUMENT SP INFO SP midi_bank_msb SP midi_bank_lsb SP midi_prog  <p>/ FX_SEND SP INFO SP sampler_channel SP fx_send_id
7198                                    
7199  </p>  </p>
7200  </blockquote><p>  </blockquote><p>
# Line 6024  Intellectual Property and Copyright Stat Line 7218  Intellectual Property and Copyright Stat
7218  <p>/ CHANNEL SP set_chan_instruction  <p>/ CHANNEL SP set_chan_instruction
7219                                    
7220  </p>  </p>
7221    <p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name
7222                    
7223    </p>
7224    <p>/ FX_SEND SP AUDIO_OUTPUT_CHANNEL SP sampler_channel SP fx_send_id SP audio_channel_index SP audio_channel_index
7225                    
7226    </p>
7227  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
7228                                    
7229  </p>  </p>
# Line 6045  Intellectual Property and Copyright Stat Line 7245  Intellectual Property and Copyright Stat
7245  <p>/ MIDI_INPUT_DEVICE SP string  <p>/ MIDI_INPUT_DEVICE SP string
7246                                    
7247  </p>  </p>
7248    <p>/ FX_SEND SP sampler_channel SP midi_ctrl
7249                    
7250    </p>
7251    <p>/ FX_SEND SP sampler_channel SP midi_ctrl SP fx_send_name
7252                    
7253    </p>
7254  </blockquote><p>  </blockquote><p>
7255    
7256  </p>  </p>
# Line 6060  Intellectual Property and Copyright Stat Line 7266  Intellectual Property and Copyright Stat
7266  <p>clear_instruction =  <p>clear_instruction =
7267          </p>          </p>
7268  <blockquote class="text">  <blockquote class="text">
7269  <p>MIDI_INSTRUMENTS  <p>MIDI_INSTRUMENTS SP midi_map
7270                    
7271    </p>
7272    <p>/ MIDI_INSTRUMENTS SP ALL
7273                                    
7274  </p>  </p>
7275  </blockquote><p>  </blockquote><p>
# Line 6075  Intellectual Property and Copyright Stat Line 7284  Intellectual Property and Copyright Stat
7284  <p>/ MIDI_INPUT_DEVICE SP number  <p>/ MIDI_INPUT_DEVICE SP number
7285                                    
7286  </p>  </p>
7287    <p>/ FX_SEND SP sampler_channel SP fx_send_id
7288                    
7289    </p>
7290  </blockquote><p>  </blockquote><p>
7291    
7292  </p>  </p>
# Line 6126  Intellectual Property and Copyright Stat Line 7338  Intellectual Property and Copyright Stat
7338  <p>/ SOLO SP sampler_channel SP boolean  <p>/ SOLO SP sampler_channel SP boolean
7339                                    
7340  </p>  </p>
7341    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP midi_map
7342                    
7343    </p>
7344    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP NONE
7345                    
7346    </p>
7347    <p>/ MIDI_INSTRUMENT_MAP SP sampler_channel SP DEFAULT
7348                    
7349    </p>
7350  </blockquote><p>  </blockquote><p>
7351    
7352  </p>  </p>
# Line 6174  Intellectual Property and Copyright Stat Line 7395  Intellectual Property and Copyright Stat
7395  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS
7396                                    
7397  </p>  </p>
7398  <p>/ MIDI_INSTRUMENTS  <p>/ MIDI_INSTRUMENTS SP midi_map
7399                    
7400    </p>
7401    <p>/ MIDI_INSTRUMENTS SP ALL
7402                    
7403    </p>
7404    <p>/ MIDI_INSTRUMENT_MAPS
7405                    
7406    </p>
7407    <p>/ FX_SENDS SP sampler_channel
7408                                    
7409  </p>  </p>
7410  </blockquote><p>  </blockquote><p>
# Line 6273  Intellectual Property and Copyright Stat Line 7503  Intellectual Property and Copyright Stat
7503  </blockquote><p>  </blockquote><p>
7504    
7505  </p>  </p>
7506  <p>midi_bank_msb =  <p>midi_map =
7507          </p>          </p>
7508  <blockquote class="text">  <blockquote class="text">
7509  <p>number  <p>number
# Line 6282  Intellectual Property and Copyright Stat Line 7512  Intellectual Property and Copyright Stat
7512  </blockquote><p>  </blockquote><p>
7513    
7514  </p>  </p>
7515  <p>midi_bank_lsb =  <p>midi_bank =
7516          </p>          </p>
7517  <blockquote class="text">  <blockquote class="text">
7518  <p>number  <p>number
# Line 6300  Intellectual Property and Copyright Stat Line 7530  Intellectual Property and Copyright Stat
7530  </blockquote><p>  </blockquote><p>
7531    
7532  </p>  </p>
7533    <p>midi_ctrl =
7534            </p>
7535    <blockquote class="text">
7536    <p>number
7537                    
7538    </p>
7539    </blockquote><p>
7540    
7541    </p>
7542  <p>volume_value =  <p>volume_value =
7543          </p>          </p>
7544  <blockquote class="text">  <blockquote class="text">
# Line 6330  Intellectual Property and Copyright Stat Line 7569  Intellectual Property and Copyright Stat
7569  </blockquote><p>  </blockquote><p>
7570    
7571  </p>  </p>
7572    <p>fx_send_id =
7573            </p>
7574    <blockquote class="text">
7575    <p>number
7576                    
7577    </p>
7578    </blockquote><p>
7579    
7580    </p>
7581  <p>engine_name =  <p>engine_name =
7582          </p>          </p>
7583  <blockquote class="text">  <blockquote class="text">
# Line 6348  Intellectual Property and Copyright Stat Line 7596  Intellectual Property and Copyright Stat
7596  </blockquote><p>  </blockquote><p>
7597    
7598  </p>  </p>
7599    <p>map_name =
7600            </p>
7601    <blockquote class="text">
7602    <p>stringval
7603                    
7604    </p>
7605    </blockquote><p>
7606    
7607    </p>
7608  <p>entry_name =  <p>entry_name =
7609          </p>          </p>
7610  <blockquote class="text">  <blockquote class="text">
# Line 6357  Intellectual Property and Copyright Stat Line 7614  Intellectual Property and Copyright Stat
7614  </blockquote><p>  </blockquote><p>
7615    
7616  </p>  </p>
7617    <p>fx_send_name =
7618            </p>
7619    <blockquote class="text">
7620    <p>stringval
7621                    
7622    </p>
7623    </blockquote><p>
7624    
7625    </p>
7626  <p>param_val_list =  <p>param_val_list =
7627          </p>          </p>
7628  <blockquote class="text">  <blockquote class="text">
# Line 6388  Intellectual Property and Copyright Stat Line 7654  Intellectual Property and Copyright Stat
7654    
7655  </p>  </p>
7656  <a name="events"></a><br /><hr />  <a name="events"></a><br /><hr />
7657  <table summary="layout" 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>
7658  <a name="rfc.section.8"></a><h3>8.&nbsp;Events</h3>  <a name="rfc.section.8"></a><h3>8.&nbsp;
7659    Events</h3>
7660    
7661  <p>This chapter will describe all currently defined events supported by LinuxSampler.  <p>This chapter will describe all currently defined events supported by LinuxSampler.
7662  </p>  </p>
7663  <a name="SUBSCRIBE CHANNEL"></a><br /><hr />  <a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT"></a><br /><hr />
7664  <table summary="layout" 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>
7665  <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;
7666    Number of audio output devices changed</h3>
7667    
7668    <p>Client may want to be notified when the total number of audio output devices on the
7669                    back-end changes by issuing the following command:
7670    </p>
7671    <p>
7672                        </p>
7673    <blockquote class="text">
7674    <p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT
7675    </p>
7676    </blockquote><p>
7677                    
7678    </p>
7679    <p>Server will start sending the following notification messages:
7680    </p>
7681    <p>
7682                        </p>
7683    <blockquote class="text">
7684    <p>"NOTIFY:AUDIO_OUTPUT_DEVICE_COUNT:&lt;devices&gt;"
7685    </p>
7686    </blockquote><p>
7687                    
7688    </p>
7689    <p>where &lt;devices&gt; will be replaced by the new number
7690                    of audio output devices.
7691    </p>
7692    <a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO"></a><br /><hr />
7693    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7694    <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;
7695    Audio output device's settings changed</h3>
7696    
7697    <p>Client may want to be notified when changes were made to audio output devices on the
7698                    back-end by issuing the following command:
7699    </p>
7700    <p>
7701                        </p>
7702    <blockquote class="text">
7703    <p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO
7704    </p>
7705    </blockquote><p>
7706                    
7707    </p>
7708    <p>Server will start sending the following notification messages:
7709    </p>
7710    <p>
7711                        </p>
7712    <blockquote class="text">
7713    <p>"NOTIFY:AUDIO_OUTPUT_DEVICE_INFO:&lt;device-id&gt;"
7714    </p>
7715    </blockquote><p>
7716                    
7717    </p>
7718    <p>where &lt;device-id&gt; will be replaced by the numerical ID of the audio output device,
7719                    which settings has been changed. The front-end will have to send
7720                    the respective command to actually get the audio output device info. Because these messages
7721                    will be triggered by LSCP commands issued by other clients rather than real
7722                    time events happening on the server, it is believed that an empty notification
7723                    message is sufficient here.
7724    </p>
7725    <a name="SUBSCRIBE MIDI_INPUT_DEVICE_COUNT"></a><br /><hr />
7726    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7727    <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;
7728    Number of MIDI input devices changed</h3>
7729    
7730    <p>Client may want to be notified when the total number of MIDI input devices on the
7731                    back-end changes by issuing the following command:
7732    </p>
7733    <p>
7734                        </p>
7735    <blockquote class="text">
7736    <p>SUBSCRIBE MIDI_INPUT_DEVICE_COUNT
7737    </p>
7738    </blockquote><p>
7739                    
7740    </p>
7741    <p>Server will start sending the following notification messages:
7742    </p>
7743    <p>
7744                        </p>
7745    <blockquote class="text">
7746    <p>"NOTIFY:MIDI_INPUT_DEVICE_COUNT:&lt;devices&gt;"
7747    </p>
7748    </blockquote><p>
7749                    
7750    </p>
7751    <p>where &lt;devices&gt; will be replaced by the new number
7752                    of MIDI input devices.
7753    </p>
7754    <a name="SUBSCRIBE MIDI_INPUT_DEVICE_INFO"></a><br /><hr />
7755    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7756    <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;
7757    MIDI input device's settings changed</h3>
7758    
7759    <p>Client may want to be notified when changes were made to MIDI input devices on the
7760                    back-end by issuing the following command:
7761    </p>
7762    <p>
7763                        </p>
7764    <blockquote class="text">
7765    <p>SUBSCRIBE MIDI_INPUT_DEVICE_INFO
7766    </p>
7767    </blockquote><p>
7768                    
7769    </p>
7770    <p>Server will start sending the following notification messages:
7771    </p>
7772    <p>
7773                        </p>
7774    <blockquote class="text">
7775    <p>"NOTIFY:MIDI_INPUT_DEVICE_INFO:&lt;device-id&gt;"
7776    </p>
7777    </blockquote><p>
7778                    
7779    </p>
7780    <p>where &lt;device-id&gt; will be replaced by the numerical ID of the MIDI input device,
7781                    which settings has been changed. The front-end will have to send
7782                    the respective command to actually get the MIDI input device info. Because these messages
7783                    will be triggered by LSCP commands issued by other clients rather than real
7784                    time events happening on the server, it is believed that an empty notification
7785                    message is sufficient here.
7786    </p>
7787    <a name="SUBSCRIBE CHANNEL_COUNT"></a><br /><hr />
7788    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7789    <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;
7790    Number of sampler channels changed</h3>
7791    
7792  <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
7793                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 6422  Intellectual Property and Copyright Stat Line 7814  Intellectual Property and Copyright Stat
7814                  of sampler channels.                  of sampler channels.
7815  </p>  </p>
7816  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
7817  <table summary="layout" 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>
7818  <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;Number of active voices changed</h3>  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;
7819    Number of active voices changed</h3>
7820    
7821  <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
7822                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 6451  Intellectual Property and Copyright Stat Line 7844  Intellectual Property and Copyright Stat
7844                  active voices on that channel.                  active voices on that channel.
7845  </p>  </p>
7846  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />
7847  <table summary="layout" 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>
7848  <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;Number of active disk streams changed</h3>  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
7849    Number of active disk streams changed</h3>
7850    
7851  <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
7852                  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 7874  Intellectual Property and Copyright Stat
7874                  active disk streams on that channel.                  active disk streams on that channel.
7875  </p>  </p>
7876  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />
7877  <table summary="layout" 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>
7878  <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;Disk stream buffer fill state changed</h3>  <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
7879    Disk stream buffer fill state changed</h3>
7880    
7881  <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
7882                  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 7901  Intellectual Property and Copyright Stat
7901  </p>  </p>
7902  <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
7903                  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
7904                  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>
7905                  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.
7906  </p>  </p>
7907  <a name="SUBSCRIBE INFO"></a><br /><hr />  <a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr />
7908  <table summary="layout" 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>
7909  <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;Channel information changed</h3>  <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
7910    Channel information changed</h3>
7911    
7912  <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
7913                  back-end by issuing the following command:                  back-end by issuing the following command:
# Line 6542  Intellectual Property and Copyright Stat Line 7938  Intellectual Property and Copyright Stat
7938                  message is sufficient here.                  message is sufficient here.
7939  </p>  </p>
7940  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
7941  <table summary="layout" 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>
7942  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;Total number of active voices changed</h3>  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
7943    Total number of active voices changed</h3>
7944    
7945  <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
7946                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 6569  Intellectual Property and Copyright Stat Line 7966  Intellectual Property and Copyright Stat
7966  <p>where &lt;voices&gt; will be replaced by the new number of  <p>where &lt;voices&gt; will be replaced by the new number of
7967                  all currently active voices.                  all currently active voices.
7968  </p>  </p>
7969    <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />
7970    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7971    <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
7972    Number of MIDI instrument maps changed</h3>
7973    
7974    <p>Client may want to be notified when the number of MIDI instrument maps on the
7975                    back-end changes by issuing the following command:
7976    </p>
7977    <p>
7978                        </p>
7979    <blockquote class="text">
7980    <p>SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT
7981    </p>
7982    </blockquote><p>
7983                    
7984    </p>
7985    <p>Server will start sending the following notification messages:
7986    </p>
7987    <p>
7988                        </p>
7989    <blockquote class="text">
7990    <p>"NOTIFY:MIDI_INSTRUMENT_MAP_COUNT:&lt;maps&gt;"
7991    </p>
7992    </blockquote><p>
7993                    
7994    </p>
7995    <p>where &lt;maps&gt; will be replaced by the new number
7996                    of MIDI instrument maps.
7997    </p>
7998    <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />
7999    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
8000    <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
8001    MIDI instrument map information changed</h3>
8002    
8003    <p>Client may want to be notified when changes were made to MIDI instrument maps on the
8004                    back-end by issuing the following command:
8005    </p>
8006    <p>
8007                        </p>
8008    <blockquote class="text">
8009    <p>SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO
8010    </p>
8011    </blockquote><p>
8012                    
8013    </p>
8014    <p>Server will start sending the following notification messages:
8015    </p>
8016    <p>
8017                        </p>
8018    <blockquote class="text">
8019    <p>"NOTIFY:MIDI_INSTRUMENT_MAP_INFO:&lt;map-id&gt;"
8020    </p>
8021    </blockquote><p>
8022                    
8023    </p>
8024    <p>where &lt;map-id&gt; will be replaced by the numerical ID of the MIDI instrument map,
8025                    for which information changes occurred. The front-end will have to send
8026                    the respective command to actually get the MIDI instrument map info. Because these messages
8027                    will be triggered by LSCP commands issued by other clients rather than real
8028                    time events happening on the server, it is believed that an empty notification
8029                    message is sufficient here.
8030    </p>
8031    <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />
8032    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
8033    <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
8034    Number of MIDI instruments changed</h3>
8035    
8036    <p>Client may want to be notified when the number of MIDI instrument maps on the
8037                    back-end changes by issuing the following command:
8038    </p>
8039    <p>
8040                        </p>
8041    <blockquote class="text">
8042    <p>SUBSCRIBE MIDI_INSTRUMENT_COUNT
8043    </p>
8044    </blockquote><p>
8045                    
8046    </p>
8047    <p>Server will start sending the following notification messages:
8048    </p>
8049    <p>
8050                        </p>
8051    <blockquote class="text">
8052    <p>"NOTIFY:MIDI_INSTRUMENT_COUNT:&lt;map-id&gt; &lt;instruments&gt;"
8053    </p>
8054    </blockquote><p>
8055                    
8056    </p>
8057    <p>where &lt;map-id&gt; is the numerical ID of the MIDI instrument map, in which
8058                    the nuber of instruments has changed and &lt;instruments&gt; will be replaced by
8059                    the new number of MIDI instruments in the specified map.
8060    </p>
8061    <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />
8062    <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
8063    <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
8064    MIDI instrument information changed</h3>
8065    
8066    <p>Client may want to be notified when changes were made to MIDI instruments on the
8067                    back-end by issuing the following command:
8068    </p>
8069    <p>
8070                        </p>
8071    <blockquote class="text">
8072    <p>SUBSCRIBE MIDI_INSTRUMENT_INFO
8073    </p>
8074    </blockquote><p>
8075                    
8076    </p>
8077    <p>Server will start sending the following notification messages:
8078    </p>
8079    <p>
8080                        </p>
8081    <blockquote class="text">
8082    <p>"NOTIFY:MIDI_INSTRUMENT_INFO:&lt;map-id&gt; &lt;bank&gt; &lt;program&gt;"
8083    </p>
8084    </blockquote><p>
8085                    
8086    </p>
8087    <p>where &lt;map-id&gt; will be replaced by the numerical ID of the MIDI instrument map,
8088                    in which a MIDI instrument is changed. &lt;bank&gt; and &lt;program&gt; specifies
8089                    the location of the changed MIDI instrument in the map. The front-end will have to send
8090                    the respective command to actually get the MIDI instrument info. Because these messages
8091                    will be triggered by LSCP commands issued by other clients rather than real
8092                    time events happening on the server, it is believed that an empty notification
8093                    message is sufficient here.
8094    </p>
8095  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
8096  <table summary="layout" 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>
8097  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;Miscellaneous and debugging events</h3>  <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
8098    Miscellaneous and debugging events</h3>
8099    
8100  <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
8101                  the server by issuing the following command:                  the server by issuing the following command:
# Line 6598  Intellectual Property and Copyright Stat Line 8122  Intellectual Property and Copyright Stat
8122                  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
8123                  user AS IS to facilitate debugging.                  user AS IS to facilitate debugging.
8124  </p>  </p>
8125  <a name="anchor15"></a><br /><hr />  <a name="anchor14"></a><br /><hr />
8126  <table summary="layout" 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>
8127  <a name="rfc.section.9"></a><h3>9.&nbsp;Security Considerations</h3>  <a name="rfc.section.9"></a><h3>9.&nbsp;
8128    Security Considerations</h3>
8129    
8130  <p>As there is so far no method of authentication and authorization  <p>As there is so far no method of authentication and authorization
8131              defined and so not required for a client applications to succeed to              defined and so not required for a client applications to succeed to
8132              connect, running LinuxSampler might be a security risk for the host              connect, running LinuxSampler might be a security risk for the host
8133              system the LinuxSampler instance is running on.              system the LinuxSampler instance is running on.
8134  </p>  </p>
8135  <a name="anchor16"></a><br /><hr />  <a name="anchor15"></a><br /><hr />
8136  <table summary="layout" 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>
8137  <a name="rfc.section.10"></a><h3>10.&nbsp;Acknowledgments</h3>  <a name="rfc.section.10"></a><h3>10.&nbsp;
8138    Acknowledgments</h3>
8139    
8140  <p>This document has benefited greatly from the comments of the  <p>This document has benefited greatly from the comments of the
8141              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 8156  Intellectual Property and Copyright Stat
8156                            
8157  </p>  </p>
8158  <a name="rfc.references1"></a><br /><hr />  <a name="rfc.references1"></a><br /><hr />
8159  <table summary="layout" 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>
8160  <h3>11.&nbsp;References</h3>  <h3>11.&nbsp;References</h3>
8161  <table width="99%" border="0">  <table width="99%" border="0">
8162  <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 8168  Intellectual Property and Copyright Stat
8168  </table>  </table>
8169    
8170  <a name="rfc.authors"></a><br /><hr />  <a name="rfc.authors"></a><br /><hr />
8171  <table summary="layout" 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>
8172  <h3>Author's Address</h3>  <h3>Author's Address</h3>
8173  <table width="99%" border="0" cellpadding="0" cellspacing="0">  <table width="99%" border="0" cellpadding="0" cellspacing="0">
8174  <tr><td class="author-text">&nbsp;</td>  <tr><td class="author-text">&nbsp;</td>
# Line 6660  Schoenebeck</td></tr> Line 8186  Schoenebeck</td></tr>
8186  <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>
8187  </table>  </table>
8188  <a name="rfc.copyright"></a><br /><hr />  <a name="rfc.copyright"></a><br /><hr />
8189  <table summary="layout" 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>
8190  <h3>Intellectual Property Statement</h3>  <h3>Full Copyright Statement</h3>
8191  <p class='copyright'>  <p class='copyright'>
8192  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>  
8193  <p class='copyright'>  <p class='copyright'>
8194  The IETF invites any interested party to bring to its  This document is subject to the rights,
8195  attention any copyrights, patents or patent applications, or  licenses and restrictions contained in BCP&nbsp;78,
8196  other proprietary rights which may cover technology that may be  and except as set forth therein,
8197  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>  
8198  <p class='copyright'>  <p class='copyright'>
8199  Copyright &copy; The Internet Society (2006). All Rights Reserved.</p>  This document and the information contained herein are provided
8200    on an &ldquo;AS IS&rdquo; basis and THE CONTRIBUTOR,
8201    THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY),
8202    THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM
8203    ALL WARRANTIES,
8204    EXPRESS OR IMPLIED,
8205    INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
8206    INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
8207    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>
8208    <h3>Intellectual Property</h3>
8209  <p class='copyright'>  <p class='copyright'>
8210  This document and translations of it may be copied and furnished to  The IETF takes no position regarding the validity or scope of any
8211  others, and derivative works that comment on or otherwise explain it  Intellectual Property Rights or other rights that might be claimed
8212  or assist in its implementation may be prepared, copied, published and  to pertain to the implementation or use of the technology
8213  distributed, in whole or in part, without restriction of any kind,  described in this document or the extent to which any license
8214  provided that the above copyright notice and this paragraph are  under such rights might or might not be available; nor does it
8215  included on all such copies and derivative works. However, this  represent that it has made any independent effort to identify any
8216  document itself may not be modified in any way, such as by removing  such rights.
8217  the copyright notice or references to the Internet Society or other  Information on the procedures with respect to
8218  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>  
8219  <p class='copyright'>  <p class='copyright'>
8220  The limited permissions granted above are perpetual and will not be  Copies of IPR disclosures made to the IETF Secretariat and any
8221  revoked by the Internet Society or its successors or assignees.</p>  assurances of licenses to be made available,
8222    or the result of an attempt made to obtain a general license or
8223    permission for the use of such proprietary rights by implementers or
8224    users of this specification can be obtained from the IETF on-line IPR
8225    repository at <a href='http://www.ietf.org/ipr'>http://www.ietf.org/ipr</a>.</p>
8226  <p class='copyright'>  <p class='copyright'>
8227  This document and the information contained herein is provided on an  The IETF invites any interested party to bring to its attention
8228  &ldquo;AS IS&rdquo; basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING  any copyrights,
8229  TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING  patents or patent applications,
8230  BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION  or other
8231  HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF  proprietary rights that may cover technology that may be required
8232  MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>  to implement this standard.
8233    Please address the information to the IETF at <a href='mailto:ietf-ipr@ietf.org'>ietf-ipr@ietf.org</a>.</p>
8234  <h3>Acknowledgment</h3>  <h3>Acknowledgment</h3>
8235  <p class='copyright'>  <p class='copyright'>
8236  Funding for the RFC Editor function is currently provided by the  Funding for the RFC Editor function is provided by
8237  Internet Society.</p>  the IETF Administrative Support Activity (IASA).</p>
8238  </body></html>  </body></html>
Legend:
Removed from v.945  
changed lines
  Added in v.1002
  ViewVC Help
Powered by ViewVC