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.31 (http://xml.resource.org/)"> |
<meta name="generator" content="xml2rfc v1.35 (http://xml.resource.org/)"> |
7 |
<style type='text/css'><!-- |
<style type='text/css'><!-- |
8 |
body { |
body { |
9 |
font-family: verdana, charcoal, helvetica, arial, sans-serif; |
font-family: verdana, charcoal, helvetica, arial, sans-serif; |
10 |
font-size: small; color: #000; background-color: #FFF; |
font-size: small; color: #000; background-color: #FFF; |
11 |
margin: 2em; |
margin: 2em; |
12 |
} |
} |
13 |
h1, h2, h3, h4, h5, h6 { |
h1, h2, h3, h4, h5, h6 { |
14 |
font-family: helvetica, monaco, "MS Sans Serif", arial, sans-serif; |
font-family: helvetica, monaco, "MS Sans Serif", arial, sans-serif; |
15 |
font-weight: bold; font-style: normal; |
font-weight: bold; font-style: normal; |
16 |
} |
} |
17 |
h1 { color: #900; background-color: transparent; text-align: right; } |
h1 { color: #900; background-color: transparent; text-align: right; } |
18 |
h3 { color: #333; background-color: transparent; } |
h3 { color: #333; background-color: transparent; } |
19 |
|
|
20 |
td.RFCbug { |
td.RFCbug { |
21 |
font-size: x-small; text-decoration: none; |
font-size: x-small; text-decoration: none; |
22 |
width: 30px; height: 30px; padding-top: 2px; |
width: 30px; height: 30px; padding-top: 2px; |
23 |
text-align: justify; vertical-align: middle; |
text-align: justify; vertical-align: middle; |
24 |
background-color: #000; |
background-color: #000; |
25 |
} |
} |
26 |
td.RFCbug span.RFC { |
td.RFCbug span.RFC { |
27 |
font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, verdana, sans-serif; |
font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, verdana, sans-serif; |
28 |
font-weight: bold; color: #666; |
font-weight: bold; color: #666; |
29 |
} |
} |
30 |
td.RFCbug span.hotText { |
td.RFCbug span.hotText { |
31 |
font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif; |
font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif; |
32 |
font-weight: normal; text-align: center; color: #FFF; |
font-weight: normal; text-align: center; color: #FFF; |
33 |
} |
} |
34 |
|
|
35 |
table.TOCbug { width: 30px; height: 15px; } |
table.TOCbug { width: 30px; height: 15px; } |
36 |
td.TOCbug { |
td.TOCbug { |
37 |
text-align: center; width: 30px; height: 15px; |
text-align: center; width: 30px; height: 15px; |
38 |
color: #FFF; background-color: #900; |
color: #FFF; background-color: #900; |
39 |
} |
} |
40 |
td.TOCbug a { |
td.TOCbug a { |
41 |
font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif; |
font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif; |
42 |
font-weight: bold; font-size: x-small; text-decoration: none; |
font-weight: bold; font-size: x-small; text-decoration: none; |
43 |
color: #FFF; background-color: transparent; |
color: #FFF; background-color: transparent; |
44 |
} |
} |
45 |
|
|
46 |
td.header { |
td.header { |
47 |
font-family: arial, helvetica, sans-serif; font-size: x-small; |
font-family: arial, helvetica, sans-serif; font-size: x-small; |
48 |
vertical-align: top; width: 33%; |
vertical-align: top; width: 33%; |
49 |
color: #FFF; background-color: #666; |
color: #FFF; background-color: #666; |
50 |
} |
} |
51 |
td.author { font-weight: bold; font-size: x-small; margin-left: 4em; } |
td.author { font-weight: bold; font-size: x-small; margin-left: 4em; } |
52 |
td.author-text { font-size: x-small; } |
td.author-text { font-size: x-small; } |
53 |
|
|
54 |
/* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */ |
/* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */ |
55 |
a.info { |
a.info { |
56 |
/* This is the key. */ |
/* This is the key. */ |
57 |
position: relative; |
position: relative; |
58 |
z-index: 24; |
z-index: 24; |
59 |
text-decoration: none; |
text-decoration: none; |
60 |
} |
} |
61 |
a.info:hover { |
a.info:hover { |
62 |
z-index: 25; |
z-index: 25; |
63 |
color: #FFF; background-color: #900; |
color: #FFF; background-color: #900; |
64 |
} |
} |
65 |
a.info span { display: none; } |
a.info span { display: none; } |
66 |
a.info:hover span.info { |
a.info:hover span.info { |
67 |
/* The span will display just on :hover state. */ |
/* The span will display just on :hover state. */ |
68 |
display: block; |
display: block; |
69 |
position: absolute; |
position: absolute; |
70 |
font-size: smaller; |
font-size: smaller; |
71 |
top: 2em; left: -5em; width: 15em; |
top: 2em; left: -5em; width: 15em; |
72 |
padding: 2px; border: 1px solid #333; |
padding: 2px; border: 1px solid #333; |
73 |
color: #900; background-color: #EEE; |
color: #900; background-color: #EEE; |
74 |
text-align: left; |
text-align: left; |
75 |
} |
} |
76 |
|
|
77 |
a { font-weight: bold; } |
a { font-weight: bold; } |
78 |
a:link { color: #900; background-color: transparent; } |
a:link { color: #900; background-color: transparent; } |
79 |
a:visited { color: #633; background-color: transparent; } |
a:visited { color: #633; background-color: transparent; } |
80 |
a:active { color: #633; background-color: transparent; } |
a:active { color: #633; background-color: transparent; } |
81 |
|
|
82 |
p { margin-left: 2em; margin-right: 2em; } |
p { margin-left: 2em; margin-right: 2em; } |
83 |
p.copyright { font-size: x-small; } |
p.copyright { font-size: x-small; } |
84 |
p.toc { font-size: small; font-weight: bold; margin-left: 3em; } |
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; } |
table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; } |
86 |
td.toc { font-size: small; font-weight: bold; vertical-align: text-top; } |
td.toc { font-size: small; font-weight: bold; vertical-align: text-top; } |
87 |
|
|
88 |
ol.text { margin-left: 2em; margin-right: 2em; } |
ol.text { margin-left: 2em; margin-right: 2em; } |
89 |
ul.text { margin-left: 2em; margin-right: 2em; } |
ul.text { margin-left: 2em; margin-right: 2em; } |
90 |
li { margin-left: 3em; } |
li { margin-left: 3em; } |
91 |
|
|
92 |
/* RFC-2629 <spanx>s and <artwork>s. */ |
/* RFC-2629 <spanx>s and <artwork>s. */ |
93 |
em { font-style: italic; } |
em { font-style: italic; } |
94 |
strong { font-weight: bold; } |
strong { font-weight: bold; } |
95 |
dfn { font-weight: bold; font-style: normal; } |
dfn { font-weight: bold; font-style: normal; } |
96 |
cite { font-weight: normal; font-style: normal; } |
cite { font-weight: normal; font-style: normal; } |
97 |
tt { color: #036; } |
tt { color: #036; } |
98 |
tt, pre, pre dfn, pre em, pre cite, pre span { |
tt, pre, pre dfn, pre em, pre cite, pre span { |
99 |
font-family: "Courier New", Courier, monospace; font-size: small; |
font-family: "Courier New", Courier, monospace; font-size: small; |
100 |
} |
} |
101 |
pre { |
pre { |
102 |
text-align: left; padding: 4px; |
text-align: left; padding: 4px; |
103 |
color: #000; background-color: #CCC; |
color: #000; background-color: #CCC; |
104 |
} |
} |
105 |
pre dfn { color: #900; } |
pre dfn { color: #900; } |
106 |
pre em { color: #66F; background-color: #FFC; font-weight: normal; } |
pre em { color: #66F; background-color: #FFC; font-weight: normal; } |
107 |
pre .key { color: #33C; font-weight: bold; } |
pre .key { color: #33C; font-weight: bold; } |
108 |
pre .id { color: #900; } |
pre .id { color: #900; } |
109 |
pre .str { color: #000; background-color: #CFF; } |
pre .str { color: #000; background-color: #CFF; } |
110 |
pre .val { color: #066; } |
pre .val { color: #066; } |
111 |
pre .rep { color: #909; } |
pre .rep { color: #909; } |
112 |
pre .oth { color: #000; background-color: #FCF; } |
pre .oth { color: #000; background-color: #FCF; } |
113 |
pre .err { background-color: #FCC; } |
pre .err { background-color: #FCC; } |
114 |
|
|
115 |
/* RFC-2629 <texttable>s. */ |
/* RFC-2629 <texttable>s. */ |
116 |
table.full, table.headers, table.none { |
table.all, table.full, table.headers, table.none { |
117 |
font-size: small; text-align: center; border-width: 2px; |
font-size: small; text-align: center; border-width: 2px; |
118 |
vertical-align: top; border-collapse: collapse; |
vertical-align: top; border-collapse: collapse; |
119 |
} |
} |
120 |
table.full { border-style: solid; border-color: black; } |
table.all, table.full { border-style: solid; border-color: black; } |
121 |
table.headers, table.none { border-style: none; } |
table.headers, table.none { border-style: none; } |
122 |
th { |
th { |
123 |
font-weight: bold; border-color: black; |
font-weight: bold; border-color: black; |
124 |
border-width: 2px 2px 3px 2px; |
border-width: 2px 2px 3px 2px; |
125 |
} |
} |
126 |
table.full th { border-style: solid; } |
table.all th, table.full th { border-style: solid; } |
127 |
table.headers th { border-style: none none solid none; } |
table.headers th { border-style: none none solid none; } |
128 |
table.none th { border-style: none; } |
table.none th { border-style: none; } |
129 |
table.full td { |
table.all td { |
130 |
border-style: solid; border-color: #333; |
border-style: solid; border-color: #333; |
131 |
border-width: 1px 2px; |
border-width: 1px 2px; |
132 |
} |
} |
133 |
table.headers td, table.none td { border-style: none; } |
table.full td, table.headers td, table.none td { border-style: none; } |
134 |
|
|
135 |
hr { height: 1px; } |
hr { height: 1px; } |
136 |
hr.insert { |
hr.insert { |
137 |
width: 80%; border-style: none; border-width: 0; |
width: 80%; border-style: none; border-width: 0; |
138 |
color: #CCC; background-color: #CCC; |
color: #CCC; background-color: #CCC; |
139 |
} |
} |
140 |
--></style> |
--></style> |
141 |
</head> |
</head> |
142 |
<body> |
<body> |
143 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </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">LinuxSampler.org</td></tr> |
147 |
<tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr> |
<tr><td class="header">Intended status: Standards Track</td><td class="header">January 9, 2014</td></tr> |
148 |
<tr><td class="header">Expires: June 18, 2007</td><td class="header">December 15, 2006</td></tr> |
<tr><td class="header">Expires: July 13, 2014</td><td class="header"> </td></tr> |
149 |
</table></td></tr></table> |
</table></td></tr></table> |
150 |
<h1><br />LinuxSampler Control Protocol<br />LSCP 1.2</h1> |
<h1><br />LinuxSampler Control Protocol<br />LSCP 1.6</h1> |
151 |
|
|
152 |
|
<h3>Abstract</h3> |
153 |
|
|
154 |
|
<p>The LinuxSampler Control Protocol (LSCP) is an |
155 |
|
application-level protocol primarily intended for local and |
156 |
|
remote controlling the LinuxSampler backend application, which is a |
157 |
|
sophisticated server-like console application essentially playing |
158 |
|
back audio samples and manipulating the samples in real time to |
159 |
|
certain extent. |
160 |
|
</p> |
161 |
<h3>Status of this Memo</h3> |
<h3>Status of this Memo</h3> |
162 |
<p> |
<p> |
163 |
By submitting this Internet-Draft, |
By submitting this Internet-Draft, |
167 |
in accordance with Section 6 of BCP 79.</p> |
in accordance with Section 6 of BCP 79.</p> |
168 |
<p> |
<p> |
169 |
Internet-Drafts are working documents of the Internet Engineering |
Internet-Drafts are working documents of the Internet Engineering |
170 |
Task Force (IETF), its areas, and its working groups. |
Task Force (IETF). Note that other groups may also distribute |
171 |
Note that other groups may also distribute working documents as |
working documents as Internet-Drafts. The list of current |
172 |
Internet-Drafts.</p> |
Internet-Drafts is at http://datatracker.ietf.org/drafts/current/.</p> |
173 |
<p> |
<p> |
174 |
Internet-Drafts are draft documents valid for a maximum of six months |
Internet-Drafts are draft documents valid for a maximum of six months |
175 |
and may be updated, replaced, or obsoleted by other documents at any time. |
and may be updated, replaced, or obsoleted by other documents at any time. |
176 |
It is inappropriate to use Internet-Drafts as reference material or to cite |
It is inappropriate to use Internet-Drafts as reference material or to cite |
177 |
them other than as “work in progress.”</p> |
them other than as “work in progress.”</p> |
178 |
<p> |
<p> |
179 |
The list of current Internet-Drafts can be accessed at |
This Internet-Draft will expire on July 13, 2014.</p> |
180 |
<a href='http://www.ietf.org/ietf/1id-abstracts.txt'>http://www.ietf.org/ietf/1id-abstracts.txt</a>.</p> |
<a name="toc"></a><br /><hr /> |
|
<p> |
|
|
The list of Internet-Draft Shadow Directories can be accessed at |
|
|
<a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p> |
|
|
<p> |
|
|
This Internet-Draft will expire on June 18, 2007.</p> |
|
|
|
|
|
<h3>Copyright Notice</h3> |
|
|
<p> |
|
|
Copyright © The Internet Society (2006).</p> |
|
|
|
|
|
<h3>Abstract</h3> |
|
|
|
|
|
<p>The LinuxSampler Control Protocol (LSCP) is an |
|
|
application-level protocol primarily intended for local and |
|
|
remote controlling the LinuxSampler backend application, which is a |
|
|
sophisticated server-like console application essentially playing |
|
|
back audio samples and manipulating the samples in real time to |
|
|
certain extent. |
|
|
</p><a name="toc"></a><br /><hr /> |
|
181 |
<h3>Table of Contents</h3> |
<h3>Table of Contents</h3> |
182 |
<p class="toc"> |
<p class="toc"> |
183 |
<a href="#anchor1">1.</a> |
<a href="#anchor1">1.</a> |
292 |
Setting audio output type<br /> |
Setting audio output type<br /> |
293 |
<a href="#SET CHANNEL AUDIO_OUTPUT_CHANNEL">6.4.16.</a> |
<a href="#SET CHANNEL AUDIO_OUTPUT_CHANNEL">6.4.16.</a> |
294 |
Setting audio output channel<br /> |
Setting audio output channel<br /> |
295 |
<a href="#SET CHANNEL MIDI_INPUT_DEVICE">6.4.17.</a> |
<a href="#ADD CHANNEL MIDI_INPUT">6.4.17.</a> |
296 |
|
Add MIDI input to sampler channel<br /> |
297 |
|
<a href="#REMOVE CHANNEL MIDI_INPUT">6.4.18.</a> |
298 |
|
Remove MIDI input(s) from sampler channel<br /> |
299 |
|
<a href="#LIST CHANNEL MIDI_INPUTS">6.4.19.</a> |
300 |
|
Getting all MIDI inputs of a sampler channel<br /> |
301 |
|
<a href="#SET CHANNEL MIDI_INPUT_DEVICE">6.4.20.</a> |
302 |
Setting MIDI input device<br /> |
Setting MIDI input device<br /> |
303 |
<a href="#SET CHANNEL MIDI_INPUT_TYPE">6.4.18.</a> |
<a href="#SET CHANNEL MIDI_INPUT_TYPE">6.4.21.</a> |
304 |
Setting MIDI input type<br /> |
Setting MIDI input type<br /> |
305 |
<a href="#SET CHANNEL MIDI_INPUT_PORT">6.4.19.</a> |
<a href="#SET CHANNEL MIDI_INPUT_PORT">6.4.22.</a> |
306 |
Setting MIDI input port<br /> |
Setting MIDI input port<br /> |
307 |
<a href="#SET CHANNEL MIDI_INPUT_CHANNEL">6.4.20.</a> |
<a href="#SET CHANNEL MIDI_INPUT_CHANNEL">6.4.23.</a> |
308 |
Setting MIDI input channel<br /> |
Setting MIDI input channel<br /> |
309 |
<a href="#SET CHANNEL VOLUME">6.4.21.</a> |
<a href="#SET CHANNEL VOLUME">6.4.24.</a> |
310 |
Setting channel volume<br /> |
Setting channel volume<br /> |
311 |
<a href="#SET CHANNEL MUTE">6.4.22.</a> |
<a href="#SET CHANNEL MUTE">6.4.25.</a> |
312 |
Muting a sampler channel<br /> |
Muting a sampler channel<br /> |
313 |
<a href="#SET CHANNEL SOLO">6.4.23.</a> |
<a href="#SET CHANNEL SOLO">6.4.26.</a> |
314 |
Soloing a sampler channel<br /> |
Soloing a sampler channel<br /> |
315 |
<a href="#SET CHANNEL MIDI_INSTRUMENT_MAP">6.4.24.</a> |
<a href="#SET CHANNEL MIDI_INSTRUMENT_MAP">6.4.27.</a> |
316 |
Assigning a MIDI instrument map to a sampler channel<br /> |
Assigning a MIDI instrument map to a sampler channel<br /> |
317 |
<a href="#RESET CHANNEL">6.4.25.</a> |
<a href="#CREATE FX_SEND">6.4.28.</a> |
318 |
|
Adding an effect send to a sampler channel<br /> |
319 |
|
<a href="#DESTROY FX_SEND">6.4.29.</a> |
320 |
|
Removing an effect send from a sampler channel<br /> |
321 |
|
<a href="#GET FX_SENDS">6.4.30.</a> |
322 |
|
Getting amount of effect sends on a sampler channel<br /> |
323 |
|
<a href="#LIST FX_SENDS">6.4.31.</a> |
324 |
|
Listing all effect sends on a sampler channel<br /> |
325 |
|
<a href="#GET FX_SEND INFO">6.4.32.</a> |
326 |
|
Getting effect send information<br /> |
327 |
|
<a href="#SET FX_SEND NAME">6.4.33.</a> |
328 |
|
Changing effect send's name<br /> |
329 |
|
<a href="#SET FX_SEND AUDIO_OUTPUT_CHANNEL">6.4.34.</a> |
330 |
|
Altering effect send's audio routing<br /> |
331 |
|
<a href="#SET FX_SEND EFFECT">6.4.35.</a> |
332 |
|
Assigning destination effect to an effect send<br /> |
333 |
|
<a href="#REMOVE FX_SEND EFFECT">6.4.36.</a> |
334 |
|
Removing destination effect from an effect send<br /> |
335 |
|
<a href="#SET FX_SEND MIDI_CONTROLLER">6.4.37.</a> |
336 |
|
Altering effect send's MIDI controller<br /> |
337 |
|
<a href="#SET FX_SEND LEVEL">6.4.38.</a> |
338 |
|
Altering effect send's send level<br /> |
339 |
|
<a href="#SEND CHANNEL MIDI_DATA">6.4.39.</a> |
340 |
|
Sending MIDI messages to sampler channel<br /> |
341 |
|
<a href="#RESET CHANNEL">6.4.40.</a> |
342 |
Resetting a sampler channel<br /> |
Resetting a sampler channel<br /> |
343 |
<a href="#anchor12">6.5.</a> |
<a href="#anchor12">6.5.</a> |
344 |
Controlling connection<br /> |
Controlling connection<br /> |
356 |
Current number of active voices<br /> |
Current number of active voices<br /> |
357 |
<a href="#GET TOTAL_VOICE_COUNT_MAX">6.6.2.</a> |
<a href="#GET TOTAL_VOICE_COUNT_MAX">6.6.2.</a> |
358 |
Maximum amount of active voices<br /> |
Maximum amount of active voices<br /> |
359 |
<a href="#RESET">6.6.3.</a> |
<a href="#GET TOTAL_STREAM_COUNT">6.6.3.</a> |
360 |
|
Current number of active disk streams<br /> |
361 |
|
<a href="#RESET">6.6.4.</a> |
362 |
Reset sampler<br /> |
Reset sampler<br /> |
363 |
<a href="#GET SERVER INFO">6.6.4.</a> |
<a href="#GET SERVER INFO">6.6.5.</a> |
364 |
General sampler informations<br /> |
General sampler informations<br /> |
365 |
|
<a href="#GET VOLUME">6.6.6.</a> |
366 |
|
Getting global volume attenuation<br /> |
367 |
|
<a href="#SET VOLUME">6.6.7.</a> |
368 |
|
Setting global volume attenuation<br /> |
369 |
|
<a href="#GET VOICES">6.6.8.</a> |
370 |
|
Getting global voice limit<br /> |
371 |
|
<a href="#SET VOICES">6.6.9.</a> |
372 |
|
Setting global voice limit<br /> |
373 |
|
<a href="#GET STREAMS">6.6.10.</a> |
374 |
|
Getting global disk stream limit<br /> |
375 |
|
<a href="#SET STREAMS">6.6.11.</a> |
376 |
|
Setting global disk stream limit<br /> |
377 |
<a href="#MIDI Instrument Mapping">6.7.</a> |
<a href="#MIDI Instrument Mapping">6.7.</a> |
378 |
MIDI Instrument Mapping<br /> |
MIDI Instrument Mapping<br /> |
379 |
<a href="#ADD MIDI_INSTRUMENT MAP">6.7.1.</a> |
<a href="#ADD MIDI_INSTRUMENT_MAP">6.7.1.</a> |
380 |
Create a new MIDI instrument map<br /> |
Create a new MIDI instrument map<br /> |
381 |
<a href="#REMOVE MIDI_INSTRUMENT_MAP">6.7.2.</a> |
<a href="#REMOVE MIDI_INSTRUMENT_MAP">6.7.2.</a> |
382 |
Delete one particular or all MIDI instrument maps<br /> |
Delete one particular or all MIDI instrument maps<br /> |
391 |
<a href="#MAP MIDI_INSTRUMENT">6.7.7.</a> |
<a href="#MAP MIDI_INSTRUMENT">6.7.7.</a> |
392 |
Create or replace a MIDI instrument map entry<br /> |
Create or replace a MIDI instrument map entry<br /> |
393 |
<a href="#GET MIDI_INSTRUMENTS">6.7.8.</a> |
<a href="#GET MIDI_INSTRUMENTS">6.7.8.</a> |
394 |
Getting ammount of MIDI instrument map entries<br /> |
Getting amount of MIDI instrument map entries<br /> |
395 |
<a href="#LIST MIDI_INSTRUMENTS">6.7.9.</a> |
<a href="#LIST MIDI_INSTRUMENTS">6.7.9.</a> |
396 |
Getting indeces of all entries of a MIDI instrument map<br /> |
Getting indeces of all entries of a MIDI instrument map<br /> |
397 |
<a href="#UNMAP MIDI_INSTRUMENT">6.7.10.</a> |
<a href="#UNMAP MIDI_INSTRUMENT">6.7.10.</a> |
400 |
Get current settings of MIDI instrument map entry<br /> |
Get current settings of MIDI instrument map entry<br /> |
401 |
<a href="#CLEAR MIDI_INSTRUMENTS">6.7.12.</a> |
<a href="#CLEAR MIDI_INSTRUMENTS">6.7.12.</a> |
402 |
Clear MIDI instrument map<br /> |
Clear MIDI instrument map<br /> |
403 |
|
<a href="#Managing Instruments Database">6.8.</a> |
404 |
|
Managing Instruments Database<br /> |
405 |
|
<a href="#ADD DB_INSTRUMENT_DIRECTORY">6.8.1.</a> |
406 |
|
Creating a new instrument directory<br /> |
407 |
|
<a href="#REMOVE DB_INSTRUMENT_DIRECTORY">6.8.2.</a> |
408 |
|
Deleting an instrument directory<br /> |
409 |
|
<a href="#GET DB_INSTRUMENT_DIRECTORIES">6.8.3.</a> |
410 |
|
Getting amount of instrument directories<br /> |
411 |
|
<a href="#LIST DB_INSTRUMENT_DIRECTORIES">6.8.4.</a> |
412 |
|
Listing all directories in specific directory<br /> |
413 |
|
<a href="#GET DB_INSTRUMENT_DIRECTORY INFO">6.8.5.</a> |
414 |
|
Getting instrument directory information<br /> |
415 |
|
<a href="#SET DB_INSTRUMENT_DIRECTORY NAME">6.8.6.</a> |
416 |
|
Renaming an instrument directory<br /> |
417 |
|
<a href="#MOVE DB_INSTRUMENT_DIRECTORY">6.8.7.</a> |
418 |
|
Moving an instrument directory<br /> |
419 |
|
<a href="#COPY DB_INSTRUMENT_DIRECTORY">6.8.8.</a> |
420 |
|
Copying instrument directories<br /> |
421 |
|
<a href="#SET DB_INSTRUMENT_DIRECTORY DESCRIPTION">6.8.9.</a> |
422 |
|
Changing the description of directory<br /> |
423 |
|
<a href="#FIND DB_INSTRUMENT_DIRECTORIES">6.8.10.</a> |
424 |
|
Finding directories<br /> |
425 |
|
<a href="#ADD DB_INSTRUMENTS">6.8.11.</a> |
426 |
|
Adding instruments to the instruments database<br /> |
427 |
|
<a href="#REMOVE DB_INSTRUMENT">6.8.12.</a> |
428 |
|
Removing an instrument<br /> |
429 |
|
<a href="#GET DB_INSTRUMENTS">6.8.13.</a> |
430 |
|
Getting amount of instruments<br /> |
431 |
|
<a href="#LIST DB_INSTRUMENTS">6.8.14.</a> |
432 |
|
Listing all instruments in specific directory<br /> |
433 |
|
<a href="#GET DB_INSTRUMENT INFO">6.8.15.</a> |
434 |
|
Getting instrument information<br /> |
435 |
|
<a href="#SET DB_INSTRUMENT NAME">6.8.16.</a> |
436 |
|
Renaming an instrument<br /> |
437 |
|
<a href="#MOVE DB_INSTRUMENT">6.8.17.</a> |
438 |
|
Moving an instrument<br /> |
439 |
|
<a href="#COPY DB_INSTRUMENT">6.8.18.</a> |
440 |
|
Copying instruments<br /> |
441 |
|
<a href="#SET DB_INSTRUMENT DESCRIPTION">6.8.19.</a> |
442 |
|
Changing the description of instrument<br /> |
443 |
|
<a href="#FIND DB_INSTRUMENTS">6.8.20.</a> |
444 |
|
Finding instruments<br /> |
445 |
|
<a href="#GET DB_INSTRUMENTS_JOB INFO">6.8.21.</a> |
446 |
|
Getting job status information<br /> |
447 |
|
<a href="#FORMAT INSTRUMENTS_DB">6.8.22.</a> |
448 |
|
Formatting the instruments database<br /> |
449 |
|
<a href="#FIND LOST DB_INSTRUMENT_FILES">6.8.23.</a> |
450 |
|
Checking for lost instrument files<br /> |
451 |
|
<a href="#SET DB_INSTRUMENT FILE_PATH">6.8.24.</a> |
452 |
|
Replacing an instrument file<br /> |
453 |
|
<a href="#editing_instruments">6.9.</a> |
454 |
|
Editing Instruments<br /> |
455 |
|
<a href="#EDIT INSTRUMENT">6.9.1.</a> |
456 |
|
Opening an appropriate instrument editor application<br /> |
457 |
|
<a href="#file_management">6.10.</a> |
458 |
|
Managing Files<br /> |
459 |
|
<a href="#GET FILE INSTRUMENTS">6.10.1.</a> |
460 |
|
Retrieving amount of instruments of a file<br /> |
461 |
|
<a href="#LIST FILE INSTRUMENTS">6.10.2.</a> |
462 |
|
Retrieving all instruments of a file<br /> |
463 |
|
<a href="#GET FILE INSTRUMENT INFO">6.10.3.</a> |
464 |
|
Retrieving informations about one instrument in a file<br /> |
465 |
|
<a href="#effects">6.11.</a> |
466 |
|
Managing Effects<br /> |
467 |
|
<a href="#GET AVAILABLE_EFFECTS">6.11.1.</a> |
468 |
|
Retrieve amount of available effects<br /> |
469 |
|
<a href="#LIST AVAILABLE_EFFECTS">6.11.2.</a> |
470 |
|
Get list of available effects<br /> |
471 |
|
<a href="#GET EFFECT INFO">6.11.3.</a> |
472 |
|
Retrieving general information about an effect<br /> |
473 |
|
<a href="#CREATE EFFECT_INSTANCE">6.11.4.</a> |
474 |
|
Creating an instance of an effect by its portable ID<br /> |
475 |
|
<a href="#CREATE EFFECT_INSTANCE (non-portable)">6.11.5.</a> |
476 |
|
Creating an instance of an effect by its numerical ID<br /> |
477 |
|
<a href="#DESTROY EFFECT_INSTANCE">6.11.6.</a> |
478 |
|
Destroy an effect instance<br /> |
479 |
|
<a href="#GET EFFECT_INSTANCES">6.11.7.</a> |
480 |
|
Retrieve amount of effect instances<br /> |
481 |
|
<a href="#LIST EFFECT_INSTANCES">6.11.8.</a> |
482 |
|
Get list of effect instances<br /> |
483 |
|
<a href="#GET EFFECT_INSTANCE INFO">6.11.9.</a> |
484 |
|
Retrieving current information about an effect instance<br /> |
485 |
|
<a href="#GET EFFECT_INSTANCE_INPUT_CONTROL INFO">6.11.10.</a> |
486 |
|
Retrieving information about an effect parameter<br /> |
487 |
|
<a href="#SET EFFECT_INSTANCE_INPUT_CONTROL VALUE">6.11.11.</a> |
488 |
|
Altering an effect parameter<br /> |
489 |
|
<a href="#GET SEND_EFFECT_CHAINS">6.11.12.</a> |
490 |
|
Retrieve amount of send effect chains<br /> |
491 |
|
<a href="#LIST SEND_EFFECT_CHAINS">6.11.13.</a> |
492 |
|
Retrieve list of send effect chains<br /> |
493 |
|
<a href="#ADD SEND_EFFECT_CHAIN">6.11.14.</a> |
494 |
|
Add send effect chain<br /> |
495 |
|
<a href="#REMOVE SEND_EFFECT_CHAIN">6.11.15.</a> |
496 |
|
Remove send effect chain<br /> |
497 |
|
<a href="#GET SEND_EFFECT_CHAIN INFO">6.11.16.</a> |
498 |
|
Retrieving information about a send effect chain<br /> |
499 |
|
<a href="#APPEND SEND_EFFECT_CHAIN EFFECT">6.11.17.</a> |
500 |
|
Append effect instance to a send effect chain<br /> |
501 |
|
<a href="#INSERT SEND_EFFECT_CHAIN EFFECT">6.11.18.</a> |
502 |
|
Insert effect instance to a send effect chain<br /> |
503 |
|
<a href="#REMOVE SEND_EFFECT_CHAIN EFFECT">6.11.19.</a> |
504 |
|
Remove effect instance from send effect chain<br /> |
505 |
<a href="#command_syntax">7.</a> |
<a href="#command_syntax">7.</a> |
506 |
Command Syntax<br /> |
Command Syntax<br /> |
507 |
|
<a href="#character_set">7.1.</a> |
508 |
|
Character Set and Escape Sequences<br /> |
509 |
<a href="#events">8.</a> |
<a href="#events">8.</a> |
510 |
Events<br /> |
Events<br /> |
511 |
<a href="#SUBSCRIBE CHANNEL">8.1.</a> |
<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT">8.1.</a> |
512 |
|
Number of audio output devices changed<br /> |
513 |
|
<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO">8.2.</a> |
514 |
|
Audio output device's settings changed<br /> |
515 |
|
<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_COUNT">8.3.</a> |
516 |
|
Number of MIDI input devices changed<br /> |
517 |
|
<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_INFO">8.4.</a> |
518 |
|
MIDI input device's settings changed<br /> |
519 |
|
<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a> |
520 |
Number of sampler channels changed<br /> |
Number of sampler channels changed<br /> |
521 |
<a href="#SUBSCRIBE VOICE_COUNT">8.2.</a> |
<a href="#SUBSCRIBE CHANNEL_MIDI">8.6.</a> |
522 |
|
MIDI data on a sampler channel arrived<br /> |
523 |
|
<a href="#SUBSCRIBE DEVICE_MIDI">8.7.</a> |
524 |
|
MIDI data on a MIDI input device arrived<br /> |
525 |
|
<a href="#SUBSCRIBE VOICE_COUNT">8.8.</a> |
526 |
Number of active voices changed<br /> |
Number of active voices changed<br /> |
527 |
<a href="#SUBSCRIBE STREAM_COUNT">8.3.</a> |
<a href="#SUBSCRIBE STREAM_COUNT">8.9.</a> |
528 |
Number of active disk streams changed<br /> |
Number of active disk streams changed<br /> |
529 |
<a href="#SUBSCRIBE BUFFER_FILL">8.4.</a> |
<a href="#SUBSCRIBE BUFFER_FILL">8.10.</a> |
530 |
Disk stream buffer fill state changed<br /> |
Disk stream buffer fill state changed<br /> |
531 |
<a href="#SUBSCRIBE INFO">8.5.</a> |
<a href="#SUBSCRIBE CHANNEL_INFO">8.11.</a> |
532 |
Channel information changed<br /> |
Channel information changed<br /> |
533 |
<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.6.</a> |
<a href="#SUBSCRIBE FX_SEND_COUNT">8.12.</a> |
534 |
|
Number of effect sends changed<br /> |
535 |
|
<a href="#SUBSCRIBE FX_SEND_INFO">8.13.</a> |
536 |
|
Effect send information changed<br /> |
537 |
|
<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.14.</a> |
538 |
Total number of active voices changed<br /> |
Total number of active voices changed<br /> |
539 |
<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a> |
<a href="#SUBSCRIBE TOTAL_STREAM_COUNT">8.15.</a> |
540 |
|
Total number of active disk streams changed<br /> |
541 |
|
<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.16.</a> |
542 |
|
Number of MIDI instrument maps changed<br /> |
543 |
|
<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.17.</a> |
544 |
|
MIDI instrument map information changed<br /> |
545 |
|
<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.18.</a> |
546 |
|
Number of MIDI instruments changed<br /> |
547 |
|
<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.19.</a> |
548 |
|
MIDI instrument information changed<br /> |
549 |
|
<a href="#SUBSCRIBE GLOBAL_INFO">8.20.</a> |
550 |
|
Global settings changed<br /> |
551 |
|
<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT">8.21.</a> |
552 |
|
Number of database instrument directories changed<br /> |
553 |
|
<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO">8.22.</a> |
554 |
|
Database instrument directory information changed<br /> |
555 |
|
<a href="#SUBSCRIBE DB_INSTRUMENT_COUNT">8.23.</a> |
556 |
|
Number of database instruments changed<br /> |
557 |
|
<a href="#SUBSCRIBE DB_INSTRUMENT_INFO">8.24.</a> |
558 |
|
Database instrument information changed<br /> |
559 |
|
<a href="#SUBSCRIBE DB_INSTRUMENTS_JOB_INFO">8.25.</a> |
560 |
|
Database job status information changed<br /> |
561 |
|
<a href="#SUBSCRIBE EFFECT_INSTANCE_COUNT">8.26.</a> |
562 |
|
Number of effect instances changed<br /> |
563 |
|
<a href="#SUBSCRIBE EFFECT_INSTANCE_INFO">8.27.</a> |
564 |
|
Effect instance information changed<br /> |
565 |
|
<a href="#SUBSCRIBE SEND_EFFECT_CHAIN_COUNT">8.28.</a> |
566 |
|
Number of send effect chains changed<br /> |
567 |
|
<a href="#SUBSCRIBE SEND_EFFECT_CHAIN_INFO">8.29.</a> |
568 |
|
Send effect chain information changed<br /> |
569 |
|
<a href="#SUBSCRIBE MISCELLANEOUS">8.30.</a> |
570 |
Miscellaneous and debugging events<br /> |
Miscellaneous and debugging events<br /> |
571 |
<a href="#anchor14">9.</a> |
<a href="#anchor14">9.</a> |
572 |
Security Considerations<br /> |
Security Considerations<br /> |
598 |
(front-end) and server (LinuxSampler) respectively. Lines in |
(front-end) and server (LinuxSampler) respectively. Lines in |
599 |
examples must be interpreted as every line being CRLF |
examples must be interpreted as every line being CRLF |
600 |
terminated (carriage return character followed by line feed |
terminated (carriage return character followed by line feed |
601 |
character as defined in the ASCII standard), thus the following |
character as defined in the ASCII standard <a class='info' href='#RFC20'>[RFC20]<span> (</span><span class='info'>UCLA, “ASCII format for Network Interchange,” 1969.</span><span>)</span></a>), |
602 |
example: |
thus the following example: |
603 |
</p> |
</p> |
604 |
<p> |
<p> |
605 |
</p> |
</p> |
3385 |
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> |
3386 |
command, <port> by the MIDI port number, <key> by the name of |
command, <port> by the MIDI port number, <key> by the name of |
3387 |
the parameter to change and <value> by the new value for this |
the parameter to change and <value> by the new value for this |
3388 |
parameter. |
parameter (encapsulated into apostrophes) or NONE (not encapsulated into apostrophes) |
3389 |
|
for specifying no value for parameters allowing a list of values. |
3390 |
</p> |
</p> |
3391 |
<p>Possible Answers: |
<p>Possible Answers: |
3392 |
</p> |
</p> |
3427 |
<p> |
<p> |
3428 |
</p> |
</p> |
3429 |
<blockquote class="text"> |
<blockquote class="text"> |
3430 |
|
<p>C: "SET MIDI_INPUT_PORT_PARAMETER 0 0 ALSA_SEQ_BINDINGS='20:0'" |
3431 |
|
</p> |
3432 |
|
<p>S: "OK" |
3433 |
|
</p> |
3434 |
|
</blockquote><p> |
3435 |
|
|
3436 |
|
</p> |
3437 |
<p> |
<p> |
3438 |
|
</p> |
3439 |
|
<blockquote class="text"> |
3440 |
|
<p>C: "SET MIDI_INPUT_PORT_PARAMETER 0 0 ALSA_SEQ_BINDINGS=NONE" |
3441 |
|
</p> |
3442 |
|
<p>S: "OK" |
3443 |
</p> |
</p> |
3444 |
</blockquote><p> |
</blockquote><p> |
3445 |
|
|
3474 |
number of the sampler channel the instrument should be assigned to. |
number of the sampler channel the instrument should be assigned to. |
3475 |
Each sampler channel can only have one instrument. |
Each sampler channel can only have one instrument. |
3476 |
</p> |
</p> |
3477 |
|
<p>Notice: since LSCP 1.2 the <filename> argument supports |
3478 |
|
escape characters for special characters (see chapter |
3479 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>" |
3480 |
|
for details) and accordingly backslash characters in the filename |
3481 |
|
MUST now be escaped as well! |
3482 |
|
</p> |
3483 |
<p>The difference between regular and NON_MODAL versions of the command |
<p>The difference between regular and NON_MODAL versions of the command |
3484 |
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 |
3485 |
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 |
3527 |
</blockquote><p> |
</blockquote><p> |
3528 |
|
|
3529 |
</p> |
</p> |
3530 |
<p>Example: |
<p>Example (Unix): |
3531 |
</p> |
</p> |
3532 |
<p> |
<p> |
3533 |
</p> |
</p> |
3534 |
<blockquote class="text"> |
<blockquote class="text"> |
3535 |
|
<p>C: LOAD INSTRUMENT '/home/joe/gigs/cello.gig' 0 0 |
3536 |
|
</p> |
3537 |
|
<p>S: OK |
3538 |
|
</p> |
3539 |
|
</blockquote><p> |
3540 |
|
|
3541 |
|
</p> |
3542 |
|
<p>Example (Windows): |
3543 |
|
</p> |
3544 |
<p> |
<p> |
3545 |
|
</p> |
3546 |
|
<blockquote class="text"> |
3547 |
|
<p>C: LOAD INSTRUMENT 'D:/MySounds/cello.gig' 0 0 |
3548 |
|
</p> |
3549 |
|
<p>S: OK |
3550 |
</p> |
</p> |
3551 |
</blockquote><p> |
</blockquote><p> |
3552 |
|
|
3919 |
<blockquote class="text"> |
<blockquote class="text"> |
3920 |
<p>C: "LIST AVAILABLE_ENGINES" |
<p>C: "LIST AVAILABLE_ENGINES" |
3921 |
</p> |
</p> |
3922 |
<p>S: "'GigEngine','AkaiEngine','DLSEngine','JoesCustomEngine'" |
<p>S: "'gig','sfz','sf2'" |
3923 |
</p> |
</p> |
3924 |
</blockquote><p> |
</blockquote><p> |
3925 |
|
|
3961 |
</p> |
</p> |
3962 |
<blockquote class="text"> |
<blockquote class="text"> |
3963 |
<p>arbitrary description text about the engine |
<p>arbitrary description text about the engine |
3964 |
|
(note that the character string may contain |
3965 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
3966 |
</p> |
</p> |
3967 |
</blockquote> |
</blockquote> |
3968 |
|
|
3983 |
</p> |
</p> |
3984 |
<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. |
3985 |
</p> |
</p> |
3986 |
<p>Example: |
<p>Examples: |
3987 |
</p> |
</p> |
3988 |
<p> |
<p> |
3989 |
</p> |
</p> |
3990 |
<blockquote class="text"> |
<blockquote class="text"> |
3991 |
<p>C: "GET ENGINE INFO JoesCustomEngine" |
<p>C: "GET ENGINE INFO gig" |
3992 |
</p> |
</p> |
3993 |
<p>S: "DESCRIPTION: this is Joe's custom sampler engine" |
<p>S: "DESCRIPTION: GigaSampler Format Engine" |
3994 |
</p> |
</p> |
3995 |
<p> "VERSION: testing-1.0" |
<p> "VERSION: 1.110" |
3996 |
|
</p> |
3997 |
|
<p> "." |
3998 |
|
</p> |
3999 |
|
<p>C: "GET ENGINE INFO sf2" |
4000 |
|
</p> |
4001 |
|
<p>S: "DESCRIPTION: SoundFont Format Engine" |
4002 |
|
</p> |
4003 |
|
<p> "VERSION: 1.4" |
4004 |
|
</p> |
4005 |
|
<p> "." |
4006 |
|
</p> |
4007 |
|
<p>C: "GET ENGINE INFO sfz" |
4008 |
|
</p> |
4009 |
|
<p>S: "DESCRIPTION: SFZ Format Engine" |
4010 |
|
</p> |
4011 |
|
<p> "VERSION: 1.11" |
4012 |
</p> |
</p> |
4013 |
<p> "." |
<p> "." |
4014 |
</p> |
</p> |
4064 |
<blockquote class="text"> |
<blockquote class="text"> |
4065 |
<p>numerical ID of the audio output device which is |
<p>numerical ID of the audio output device which is |
4066 |
currently connected to this sampler channel to output |
currently connected to this sampler channel to output |
4067 |
the audio signal, "NONE" if there's no device |
the audio signal, "-1" if there's no device |
4068 |
connected to this sampler channel |
connected to this sampler channel |
4069 |
</p> |
</p> |
4070 |
</blockquote> |
</blockquote> |
4098 |
<blockquote class="text"> |
<blockquote class="text"> |
4099 |
<p>the file name of the loaded instrument, "NONE" if |
<p>the file name of the loaded instrument, "NONE" if |
4100 |
there's no instrument yet loaded for this sampler |
there's no instrument yet loaded for this sampler |
4101 |
channel |
channel (note: since LSCP 1.2 this path may contain |
4102 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
4103 |
</p> |
</p> |
4104 |
</blockquote> |
</blockquote> |
4105 |
|
|
4107 |
<p>INSTRUMENT_NR - |
<p>INSTRUMENT_NR - |
4108 |
</p> |
</p> |
4109 |
<blockquote class="text"> |
<blockquote class="text"> |
4110 |
<p>the instrument index number of the loaded instrument |
<p>the instrument index number of the loaded instrument, |
4111 |
|
"-1" if there's no instrument loaded for this sampler |
4112 |
|
channel |
4113 |
</p> |
</p> |
4114 |
</blockquote> |
</blockquote> |
4115 |
|
|
4118 |
</p> |
</p> |
4119 |
<blockquote class="text"> |
<blockquote class="text"> |
4120 |
<p>the instrument name of the loaded instrument |
<p>the instrument name of the loaded instrument |
4121 |
|
(note: since LSCP 1.2 this character string may contain |
4122 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
4123 |
</p> |
</p> |
4124 |
</blockquote> |
</blockquote> |
4125 |
|
|
4127 |
<p>INSTRUMENT_STATUS - |
<p>INSTRUMENT_STATUS - |
4128 |
</p> |
</p> |
4129 |
<blockquote class="text"> |
<blockquote class="text"> |
4130 |
<p>integer values 0 to 100 indicating loading progress percentage for the instrument. Negative |
<p>Integer values 0 to 100 indicating loading progress |
4131 |
value indicates a loading exception. Value of 100 indicates that the instrument is fully |
percentage for the instrument. Negative |
4132 |
|
value indicates a loading exception (also returns "-1" in case no |
4133 |
|
instrument was yet to be loaded on the sampler channel). |
4134 |
|
Value of 100 indicates that the instrument is fully |
4135 |
loaded. |
loaded. |
4136 |
</p> |
</p> |
4137 |
</blockquote> |
</blockquote> |
4142 |
<blockquote class="text"> |
<blockquote class="text"> |
4143 |
<p>numerical ID of the MIDI input device which is |
<p>numerical ID of the MIDI input device which is |
4144 |
currently connected to this sampler channel to deliver |
currently connected to this sampler channel to deliver |
4145 |
MIDI input commands, "NONE" if there's no device |
MIDI input commands, "-1" if there's no device |
4146 |
connected to this sampler channel |
connected to this sampler channel |
4147 |
</p> |
</p> |
4148 |
</blockquote> |
</blockquote> |
4151 |
<p>MIDI_INPUT_PORT - |
<p>MIDI_INPUT_PORT - |
4152 |
</p> |
</p> |
4153 |
<blockquote class="text"> |
<blockquote class="text"> |
4154 |
<p>port number of the MIDI input device |
<p>port number of the MIDI input device (in case a |
4155 |
|
MIDI device was already assigned to the sampler |
4156 |
|
channel) |
4157 |
</p> |
</p> |
4158 |
</blockquote> |
</blockquote> |
4159 |
|
|
4171 |
</p> |
</p> |
4172 |
<blockquote class="text"> |
<blockquote class="text"> |
4173 |
<p>optionally dotted number for the channel volume factor |
<p>optionally dotted number for the channel volume factor |
4174 |
(where a value < 1.0 means attenuation and a value > |
(where a value < 1.0 means attenuation and a value > |
4175 |
1.0 means amplification) |
1.0 means amplification) |
4176 |
</p> |
</p> |
4177 |
</blockquote> |
</blockquote> |
4224 |
<blockquote class="text"> |
<blockquote class="text"> |
4225 |
<p>C: "GET CHANNEL INFO 34" |
<p>C: "GET CHANNEL INFO 34" |
4226 |
</p> |
</p> |
4227 |
<p>S: "ENGINE_NAME: GigEngine" |
<p>S: "ENGINE_NAME: gig" |
4228 |
</p> |
</p> |
4229 |
<p> "VOLUME: 1.0" |
<p> "VOLUME: 1.0" |
4230 |
</p> |
</p> |
4496 |
<a name="rfc.section.6.4.15"></a><h3>6.4.15. |
<a name="rfc.section.6.4.15"></a><h3>6.4.15. |
4497 |
Setting audio output type</h3> |
Setting audio output type</h3> |
4498 |
|
|
4499 |
<p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON! |
<p>DEPRECATED: THIS COMMAND WILL DISAPPEAR! |
4500 |
</p> |
</p> |
4501 |
<p>The front-end can alter the audio output type on a specific sampler |
<p>The front-end can alter the audio output type on a specific sampler |
4502 |
channel by sending the following command: |
channel by sending the following command: |
4556 |
</blockquote><p> |
</blockquote><p> |
4557 |
|
|
4558 |
</p> |
</p> |
4559 |
|
<p>Deprecated: |
4560 |
|
</p> |
4561 |
|
<p> |
4562 |
|
</p> |
4563 |
|
<blockquote class="text"> |
4564 |
|
<p>Should not be used anymore. This command is currently only preserved for backward compatibility. |
4565 |
|
</p> |
4566 |
|
<p>This command is a relict from times where there was no sophisticated driver management yet. Use <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> and <a class='info' href='#SET CHANNEL AUDIO_OUTPUT_DEVICE'>"SET CHANNEL AUDIO_OUTPUT_DEVICE"<span> (</span><span class='info'>Setting audio output device</span><span>)</span></a> instead. |
4567 |
|
</p> |
4568 |
|
</blockquote><p> |
4569 |
|
|
4570 |
|
</p> |
4571 |
<a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr /> |
<a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr /> |
4572 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
4573 |
<a name="rfc.section.6.4.16"></a><h3>6.4.16. |
<a name="rfc.section.6.4.16"></a><h3>6.4.16. |
4635 |
</blockquote><p> |
</blockquote><p> |
4636 |
|
|
4637 |
</p> |
</p> |
4638 |
<a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr /> |
<a name="ADD CHANNEL MIDI_INPUT"></a><br /><hr /> |
4639 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
4640 |
<a name="rfc.section.6.4.17"></a><h3>6.4.17. |
<a name="rfc.section.6.4.17"></a><h3>6.4.17. |
4641 |
|
Add MIDI input to sampler channel</h3> |
4642 |
|
|
4643 |
|
<p>The front-end can add a MIDI input on a specific sampler |
4644 |
|
channel by sending the following command: |
4645 |
|
</p> |
4646 |
|
<p> |
4647 |
|
</p> |
4648 |
|
<blockquote class="text"> |
4649 |
|
<p>ADD CHANNEL MIDI_INPUT <sampler-channel> <midi-device-id> [<midi-input-port>] |
4650 |
|
</p> |
4651 |
|
</blockquote><p> |
4652 |
|
|
4653 |
|
</p> |
4654 |
|
<p>Where <sampler-channel> is the sampler channel number |
4655 |
|
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> |
4656 |
|
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 |
4657 |
|
and <midi-device-id> is the numerical ID of the MIDI input |
4658 |
|
device as returned by the |
4659 |
|
<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> |
4660 |
|
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, |
4661 |
|
and <midi-input-port> is an optional MIDI input port number of that |
4662 |
|
MIDI input device. If <midi-input-port> is omitted, |
4663 |
|
then the MIDI input device's first port (port number 0) is |
4664 |
|
used. |
4665 |
|
|
4666 |
|
</p> |
4667 |
|
<p>Possible Answers: |
4668 |
|
</p> |
4669 |
|
<p> |
4670 |
|
</p> |
4671 |
|
<blockquote class="text"> |
4672 |
|
<p>"OK" - |
4673 |
|
</p> |
4674 |
|
<blockquote class="text"> |
4675 |
|
<p>on success |
4676 |
|
</p> |
4677 |
|
</blockquote> |
4678 |
|
|
4679 |
|
|
4680 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
4681 |
|
</p> |
4682 |
|
<blockquote class="text"> |
4683 |
|
<p>if MIDI input port was connected, but there are noteworthy |
4684 |
|
issue(s) related, providing an appropriate warning code and |
4685 |
|
warning message |
4686 |
|
</p> |
4687 |
|
</blockquote> |
4688 |
|
|
4689 |
|
|
4690 |
|
<p>"ERR:<error-code>:<error-message>" - |
4691 |
|
</p> |
4692 |
|
<blockquote class="text"> |
4693 |
|
<p>in case it failed, providing an appropriate error code and error message |
4694 |
|
</p> |
4695 |
|
</blockquote> |
4696 |
|
|
4697 |
|
|
4698 |
|
</blockquote><p> |
4699 |
|
|
4700 |
|
</p> |
4701 |
|
<p>Examples: |
4702 |
|
</p> |
4703 |
|
<p> |
4704 |
|
</p> |
4705 |
|
<blockquote class="text"> |
4706 |
|
<p>C: "ADD CHANNEL MIDI_INPUT 0 0" |
4707 |
|
</p> |
4708 |
|
<p>S: "OK" |
4709 |
|
</p> |
4710 |
|
<p>C: "ADD CHANNEL MIDI_INPUT 1 0" |
4711 |
|
</p> |
4712 |
|
<p>S: "OK" |
4713 |
|
</p> |
4714 |
|
<p>C: "ADD CHANNEL MIDI_INPUT 1 1 1" |
4715 |
|
</p> |
4716 |
|
<p>S: "OK" |
4717 |
|
</p> |
4718 |
|
<p>C: "ADD CHANNEL MIDI_INPUT 1 2 0" |
4719 |
|
</p> |
4720 |
|
<p>S: "OK" |
4721 |
|
</p> |
4722 |
|
</blockquote><p> |
4723 |
|
|
4724 |
|
</p> |
4725 |
|
<p>Since: |
4726 |
|
</p> |
4727 |
|
<p> |
4728 |
|
</p> |
4729 |
|
<blockquote class="text"> |
4730 |
|
<p>Introduced with LSCP v1.6 |
4731 |
|
</p> |
4732 |
|
</blockquote><p> |
4733 |
|
|
4734 |
|
</p> |
4735 |
|
<a name="REMOVE CHANNEL MIDI_INPUT"></a><br /><hr /> |
4736 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
4737 |
|
<a name="rfc.section.6.4.18"></a><h3>6.4.18. |
4738 |
|
Remove MIDI input(s) from sampler channel</h3> |
4739 |
|
|
4740 |
|
<p>The front-end can remove one ore more MIDI input(s) on a |
4741 |
|
specific sampler channel by sending the following command: |
4742 |
|
</p> |
4743 |
|
<p> |
4744 |
|
</p> |
4745 |
|
<blockquote class="text"> |
4746 |
|
<p>REMOVE CHANNEL MIDI_INPUT <sampler-channel> [<midi-device-id> [<midi-input-port>]] |
4747 |
|
</p> |
4748 |
|
</blockquote><p> |
4749 |
|
|
4750 |
|
</p> |
4751 |
|
<p>Where <sampler-channel> is the sampler channel number |
4752 |
|
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> |
4753 |
|
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 |
4754 |
|
and <midi-device-id> and <midi-input-port> are |
4755 |
|
optional numerical IDs defining the MIDI input device and |
4756 |
|
one of its MIDI ports as returned by the |
4757 |
|
<a class='info' href='#LIST CHANNEL MIDI_INPUTS'>"LIST CHANNEL MIDI_INPUTS"<span> (</span><span class='info'>Getting all MIDI inputs of a sampler channel</span><span>)</span></a> command. |
4758 |
|
|
4759 |
|
</p> |
4760 |
|
<p> |
4761 |
|
If <midi-input-port> is omitted, then all MIDI input |
4762 |
|
ports of <midi-device-id> are disconnected from this |
4763 |
|
sampler channel. |
4764 |
|
|
4765 |
|
</p> |
4766 |
|
<p> |
4767 |
|
If both, <midi-device-id> and <midi-input-port> |
4768 |
|
are omitted, then all MIDI input ports currently connected |
4769 |
|
to this sampler channel are disconnected from this sampler |
4770 |
|
channel. |
4771 |
|
|
4772 |
|
</p> |
4773 |
|
<p>Possible Answers: |
4774 |
|
</p> |
4775 |
|
<p> |
4776 |
|
</p> |
4777 |
|
<blockquote class="text"> |
4778 |
|
<p>"OK" - |
4779 |
|
</p> |
4780 |
|
<blockquote class="text"> |
4781 |
|
<p>on success |
4782 |
|
</p> |
4783 |
|
</blockquote> |
4784 |
|
|
4785 |
|
|
4786 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
4787 |
|
</p> |
4788 |
|
<blockquote class="text"> |
4789 |
|
<p>if MIDI input porst were disconnected, but there are noteworthy |
4790 |
|
issue(s) related, providing an appropriate warning code and |
4791 |
|
warning message |
4792 |
|
</p> |
4793 |
|
</blockquote> |
4794 |
|
|
4795 |
|
|
4796 |
|
<p>"ERR:<error-code>:<error-message>" - |
4797 |
|
</p> |
4798 |
|
<blockquote class="text"> |
4799 |
|
<p>in case it failed, providing an appropriate error code and error message |
4800 |
|
</p> |
4801 |
|
</blockquote> |
4802 |
|
|
4803 |
|
|
4804 |
|
</blockquote><p> |
4805 |
|
|
4806 |
|
</p> |
4807 |
|
<p>Examples: |
4808 |
|
</p> |
4809 |
|
<p> |
4810 |
|
</p> |
4811 |
|
<blockquote class="text"> |
4812 |
|
<p>C: "REMOVE CHANNEL MIDI_INPUT 0" |
4813 |
|
</p> |
4814 |
|
<p>S: "OK" |
4815 |
|
</p> |
4816 |
|
<p>C: "REMOVE CHANNEL MIDI_INPUT 1" |
4817 |
|
</p> |
4818 |
|
<p>S: "OK" |
4819 |
|
</p> |
4820 |
|
<p>C: "REMOVE CHANNEL MIDI_INPUT 1 2 0" |
4821 |
|
</p> |
4822 |
|
<p>S: "OK" |
4823 |
|
</p> |
4824 |
|
</blockquote><p> |
4825 |
|
|
4826 |
|
</p> |
4827 |
|
<p>Since: |
4828 |
|
</p> |
4829 |
|
<p> |
4830 |
|
</p> |
4831 |
|
<blockquote class="text"> |
4832 |
|
<p>Introduced with LSCP v1.6 |
4833 |
|
</p> |
4834 |
|
</blockquote><p> |
4835 |
|
|
4836 |
|
</p> |
4837 |
|
<a name="LIST CHANNEL MIDI_INPUTS"></a><br /><hr /> |
4838 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
4839 |
|
<a name="rfc.section.6.4.19"></a><h3>6.4.19. |
4840 |
|
Getting all MIDI inputs of a sampler channel</h3> |
4841 |
|
|
4842 |
|
<p>The front-end can query a list of all currently connected |
4843 |
|
MIDI inputs of a certain sampler channel by sending the following |
4844 |
|
command: |
4845 |
|
</p> |
4846 |
|
<p> |
4847 |
|
</p> |
4848 |
|
<blockquote class="text"> |
4849 |
|
<p>LIST CHANNEL MIDI_INPUTS <sampler-channel> |
4850 |
|
</p> |
4851 |
|
</blockquote><p> |
4852 |
|
|
4853 |
|
</p> |
4854 |
|
<p>Where <sampler-channel> is the sampler channel number |
4855 |
|
as returned by the <a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a> |
4856 |
|
or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command. |
4857 |
|
|
4858 |
|
</p> |
4859 |
|
<p>Possible Answers: |
4860 |
|
</p> |
4861 |
|
<p> |
4862 |
|
</p> |
4863 |
|
<blockquote class="text"> |
4864 |
|
<p>The sampler will answer by sending a comma separated |
4865 |
|
list of MIDI input device ID - MIDI input port number pairs, where |
4866 |
|
each pair is encapsulated into curly braces. The |
4867 |
|
list is returned in one single line. The MIDI input |
4868 |
|
device ID corresponds to the number returned by |
4869 |
|
<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> |
4870 |
|
and the port number is the index of the respective MIDI |
4871 |
|
port of that MIDI input device. |
4872 |
|
</p> |
4873 |
|
</blockquote><p> |
4874 |
|
|
4875 |
|
</p> |
4876 |
|
<p>Example: |
4877 |
|
</p> |
4878 |
|
<p> |
4879 |
|
</p> |
4880 |
|
<blockquote class="text"> |
4881 |
|
<p>C: "LIST CHANNEL MIDI_INPUTS 0" |
4882 |
|
</p> |
4883 |
|
<p>S: "{0,0},{1,3},{2,0}" |
4884 |
|
</p> |
4885 |
|
</blockquote><p> |
4886 |
|
|
4887 |
|
</p> |
4888 |
|
<p>Since: |
4889 |
|
</p> |
4890 |
|
<p> |
4891 |
|
</p> |
4892 |
|
<blockquote class="text"> |
4893 |
|
<p>Introduced with LSCP v1.6 |
4894 |
|
</p> |
4895 |
|
</blockquote><p> |
4896 |
|
|
4897 |
|
</p> |
4898 |
|
<a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr /> |
4899 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
4900 |
|
<a name="rfc.section.6.4.20"></a><h3>6.4.20. |
4901 |
Setting MIDI input device</h3> |
Setting MIDI input device</h3> |
4902 |
|
|
4903 |
|
<p>DEPRECATED: THIS COMMAND WILL DISAPPEAR! |
4904 |
|
</p> |
4905 |
<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 |
4906 |
channel by sending the following command: |
channel by sending the following command: |
4907 |
</p> |
</p> |
4920 |
<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> |
4921 |
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. |
4922 |
</p> |
</p> |
4923 |
|
<p> |
4924 |
|
If more than 1 MIDI inputs are currently connected to this |
4925 |
|
sampler channel: Sending this command will disconnect ALL |
4926 |
|
currently connected MIDI input ports connected to this |
4927 |
|
sampler channel before establishing the new MIDI input |
4928 |
|
connection. So this command does NOT add the connection, |
4929 |
|
it replaces all existing ones instead. This behavior is due |
4930 |
|
to preserving full behavior backward compatibility. |
4931 |
|
|
4932 |
|
</p> |
4933 |
<p>Possible Answers: |
<p>Possible Answers: |
4934 |
</p> |
</p> |
4935 |
<p> |
<p> |
4974 |
</blockquote><p> |
</blockquote><p> |
4975 |
|
|
4976 |
</p> |
</p> |
4977 |
|
<p>Deprecated: |
4978 |
|
</p> |
4979 |
|
<p> |
4980 |
|
</p> |
4981 |
|
<blockquote class="text"> |
4982 |
|
<p>Should not be used anymore as of LSCP v1.6 and younger. This command is currently only preserved for backward compatibility. |
4983 |
|
</p> |
4984 |
|
<p>This command is a relict from times where only one MIDI input per sampler channel was allowed. Use <a class='info' href='#ADD CHANNEL MIDI_INPUT'>"ADD CHANNEL MIDI_INPUT"<span> (</span><span class='info'>Add MIDI input to sampler channel</span><span>)</span></a> and <a class='info' href='#REMOVE CHANNEL MIDI_INPUT'>"REMOVE CHANNEL MIDI_INPUT"<span> (</span><span class='info'>Remove MIDI input(s) from sampler channel</span><span>)</span></a> instead. |
4985 |
|
</p> |
4986 |
|
</blockquote><p> |
4987 |
|
|
4988 |
|
</p> |
4989 |
<a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr /> |
<a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr /> |
4990 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
4991 |
<a name="rfc.section.6.4.18"></a><h3>6.4.18. |
<a name="rfc.section.6.4.21"></a><h3>6.4.21. |
4992 |
Setting MIDI input type</h3> |
Setting MIDI input type</h3> |
4993 |
|
|
4994 |
<p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON! |
<p>DEPRECATED: THIS COMMAND WILL DISAPPEAR! |
4995 |
</p> |
</p> |
4996 |
<p>The front-end can alter the MIDI input type on a specific sampler |
<p>The front-end can alter the MIDI input type on a specific sampler |
4997 |
channel by sending the following command: |
channel by sending the following command: |
5007 |
<p>Where <midi-input-type> is currently only "ALSA" and |
<p>Where <midi-input-type> is currently only "ALSA" and |
5008 |
<sampler-channel> is the respective sampler channel number. |
<sampler-channel> is the respective sampler channel number. |
5009 |
</p> |
</p> |
5010 |
|
<p> |
5011 |
|
If more than 1 MIDI inputs are currently connected to this |
5012 |
|
sampler channel: Sending this command will disconnect ALL |
5013 |
|
currently connected MIDI input ports connected to this |
5014 |
|
sampler channel before establishing the new MIDI input |
5015 |
|
connection. So this command does NOT add the connection, |
5016 |
|
it replaces all existing ones instead. This behavior is due |
5017 |
|
to preserving full behavior backward compatibility. |
5018 |
|
|
5019 |
|
</p> |
5020 |
<p>Possible Answers: |
<p>Possible Answers: |
5021 |
</p> |
</p> |
5022 |
<p> |
<p> |
5061 |
</blockquote><p> |
</blockquote><p> |
5062 |
|
|
5063 |
</p> |
</p> |
5064 |
|
<p>Deprecated: |
5065 |
|
</p> |
5066 |
|
<p> |
5067 |
|
</p> |
5068 |
|
<blockquote class="text"> |
5069 |
|
<p>Should not be used anymore. This command is currently only preserved for backward compatibility. |
5070 |
|
</p> |
5071 |
|
<p>This command is a relict from times where only 1 MIDI input per sampler channels was allowed and where no sophisticated driver management existed yet. Use <a class='info' href='#ADD CHANNEL MIDI_INPUT'>"ADD CHANNEL MIDI_INPUT"<span> (</span><span class='info'>Add MIDI input to sampler channel</span><span>)</span></a> and <a class='info' href='#REMOVE CHANNEL MIDI_INPUT'>"REMOVE CHANNEL MIDI_INPUT"<span> (</span><span class='info'>Remove MIDI input(s) from sampler channel</span><span>)</span></a> instead. |
5072 |
|
</p> |
5073 |
|
</blockquote><p> |
5074 |
|
|
5075 |
|
</p> |
5076 |
<a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr /> |
<a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr /> |
5077 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5078 |
<a name="rfc.section.6.4.19"></a><h3>6.4.19. |
<a name="rfc.section.6.4.22"></a><h3>6.4.22. |
5079 |
Setting MIDI input port</h3> |
Setting MIDI input port</h3> |
5080 |
|
|
5081 |
|
<p>DEPRECATED: THIS COMMAND WILL DISAPPEAR! |
5082 |
|
</p> |
5083 |
<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 |
5084 |
channel by sending the following command: |
channel by sending the following command: |
5085 |
</p> |
</p> |
5095 |
MIDI input device connected to the sampler channel given by |
MIDI input device connected to the sampler channel given by |
5096 |
<sampler-channel>. |
<sampler-channel>. |
5097 |
</p> |
</p> |
5098 |
|
<p> |
5099 |
|
If more than 1 MIDI inputs are currently connected to this |
5100 |
|
sampler channel: Sending this command will switch the |
5101 |
|
connection of the first (and only the first) MIDI input port |
5102 |
|
currently being connected to this sampler channel, to |
5103 |
|
another port of the same MIDI input device. Or in other |
5104 |
|
words: the first MIDI input port currently connected to |
5105 |
|
this sampler channel will be disconnected, and the requested |
5106 |
|
other port of its MIDI input device will be connected to |
5107 |
|
this sampler channel instead. This behavior is due |
5108 |
|
to preserving full behavior backward compatibility. |
5109 |
|
|
5110 |
|
</p> |
5111 |
<p>Possible Answers: |
<p>Possible Answers: |
5112 |
</p> |
</p> |
5113 |
<p> |
<p> |
5152 |
</blockquote><p> |
</blockquote><p> |
5153 |
|
|
5154 |
</p> |
</p> |
5155 |
|
<p>Deprecated: |
5156 |
|
</p> |
5157 |
|
<p> |
5158 |
|
</p> |
5159 |
|
<blockquote class="text"> |
5160 |
|
<p>Should not be used anymore. This command is currently only preserved for backward compatibility. |
5161 |
|
</p> |
5162 |
|
<p>This command is a relict from times where only one MIDI input per sampler channel was allowed. Use <a class='info' href='#ADD CHANNEL MIDI_INPUT'>"ADD CHANNEL MIDI_INPUT"<span> (</span><span class='info'>Add MIDI input to sampler channel</span><span>)</span></a> and <a class='info' href='#REMOVE CHANNEL MIDI_INPUT'>"REMOVE CHANNEL MIDI_INPUT"<span> (</span><span class='info'>Remove MIDI input(s) from sampler channel</span><span>)</span></a> instead. |
5163 |
|
</p> |
5164 |
|
</blockquote><p> |
5165 |
|
|
5166 |
|
</p> |
5167 |
<a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr /> |
<a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr /> |
5168 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5169 |
<a name="rfc.section.6.4.20"></a><h3>6.4.20. |
<a name="rfc.section.6.4.23"></a><h3>6.4.23. |
5170 |
Setting MIDI input channel</h3> |
Setting MIDI input channel</h3> |
5171 |
|
|
5172 |
<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 |
5180 |
</blockquote><p> |
</blockquote><p> |
5181 |
|
|
5182 |
</p> |
</p> |
5183 |
<p>Where <midi-input-chan> is the number of the new MIDI input channel where |
<p>Where <midi-input-chan> is the number |
5184 |
<sampler-channel> should listen to or "ALL" to listen on all 16 MIDI |
of the new MIDI input channel (zero indexed!) where |
5185 |
|
<sampler-channel> should listen to, or "ALL" to listen on all 16 MIDI |
5186 |
channels. |
channels. |
5187 |
</p> |
</p> |
5188 |
<p>Possible Answers: |
<p>Possible Answers: |
5224 |
<p> |
<p> |
5225 |
</p> |
</p> |
5226 |
<blockquote class="text"> |
<blockquote class="text"> |
5227 |
<p> |
<p>C: "SET CHANNEL MIDI_INPUT_CHANNEL 0 0" |
5228 |
|
</p> |
5229 |
|
<p>S: "OK" |
5230 |
|
</p> |
5231 |
|
<p>C: "SET CHANNEL MIDI_INPUT_CHANNEL 1 ALL" |
5232 |
|
</p> |
5233 |
|
<p>S: "OK" |
5234 |
</p> |
</p> |
5235 |
</blockquote><p> |
</blockquote><p> |
5236 |
|
|
5237 |
</p> |
</p> |
5238 |
<a name="SET CHANNEL VOLUME"></a><br /><hr /> |
<a name="SET CHANNEL VOLUME"></a><br /><hr /> |
5239 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5240 |
<a name="rfc.section.6.4.21"></a><h3>6.4.21. |
<a name="rfc.section.6.4.24"></a><h3>6.4.24. |
5241 |
Setting channel volume</h3> |
Setting channel volume</h3> |
5242 |
|
|
5243 |
<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 |
5302 |
</p> |
</p> |
5303 |
<a name="SET CHANNEL MUTE"></a><br /><hr /> |
<a name="SET CHANNEL MUTE"></a><br /><hr /> |
5304 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5305 |
<a name="rfc.section.6.4.22"></a><h3>6.4.22. |
<a name="rfc.section.6.4.25"></a><h3>6.4.25. |
5306 |
Muting a sampler channel</h3> |
Muting a sampler channel</h3> |
5307 |
|
|
5308 |
<p>The front-end can mute/unmute a specific sampler |
<p>The front-end can mute/unmute a specific sampler |
5368 |
</p> |
</p> |
5369 |
<a name="SET CHANNEL SOLO"></a><br /><hr /> |
<a name="SET CHANNEL SOLO"></a><br /><hr /> |
5370 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5371 |
<a name="rfc.section.6.4.23"></a><h3>6.4.23. |
<a name="rfc.section.6.4.26"></a><h3>6.4.26. |
5372 |
Soloing a sampler channel</h3> |
Soloing a sampler channel</h3> |
5373 |
|
|
5374 |
<p>The front-end can solo/unsolo a specific sampler channel |
<p>The front-end can solo/unsolo a specific sampler channel |
5434 |
</p> |
</p> |
5435 |
<a name="SET CHANNEL MIDI_INSTRUMENT_MAP"></a><br /><hr /> |
<a name="SET CHANNEL MIDI_INSTRUMENT_MAP"></a><br /><hr /> |
5436 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5437 |
<a name="rfc.section.6.4.24"></a><h3>6.4.24. |
<a name="rfc.section.6.4.27"></a><h3>6.4.27. |
5438 |
Assigning a MIDI instrument map to a sampler channel</h3> |
Assigning a MIDI instrument map to a sampler channel</h3> |
5439 |
|
|
5440 |
<p>The front-end can assign a MIDI instrument map to a specific sampler channel |
<p>The front-end can assign a MIDI instrument map to a specific sampler channel |
5530 |
</blockquote><p> |
</blockquote><p> |
5531 |
|
|
5532 |
</p> |
</p> |
5533 |
|
<a name="CREATE FX_SEND"></a><br /><hr /> |
5534 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5535 |
|
<a name="rfc.section.6.4.28"></a><h3>6.4.28. |
5536 |
|
Adding an effect send to a sampler channel</h3> |
5537 |
|
|
5538 |
|
<p>The front-end can create an additional effect send on a specific sampler channel |
5539 |
|
by sending the following command: |
5540 |
|
</p> |
5541 |
|
<p> |
5542 |
|
</p> |
5543 |
|
<blockquote class="text"> |
5544 |
|
<p>CREATE FX_SEND <sampler-channel> <midi-ctrl> [<name>] |
5545 |
|
</p> |
5546 |
|
</blockquote><p> |
5547 |
|
|
5548 |
|
</p> |
5549 |
|
<p>Where <sampler-channel> is the respective sampler channel |
5550 |
|
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> |
5551 |
|
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 |
5552 |
|
sampler channel on which the effect send should be created on, <midi-ctrl> |
5553 |
|
is a number between 0..127 defining the MIDI controller which can alter the |
5554 |
|
effect send level and <name> is an optional argument defining a name |
5555 |
|
for the effect send entity. The name does not have to be unique, but MUST be |
5556 |
|
encapsulated into apostrophes and supports escape sequences as described in chapter |
5557 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>". |
5558 |
|
</p> |
5559 |
|
<p>By default, that is as initial routing, the effect send's audio channels |
5560 |
|
are automatically routed to the last audio channels of the sampler channel's |
5561 |
|
audio output device, that way you can i.e. first increase the amount of audio |
5562 |
|
channels on the audio output device for having dedicated effect send output |
5563 |
|
channels and when "CREATE FX_SEND" is called, those channels will automatically |
5564 |
|
be picked. You can alter the destination channels however with |
5565 |
|
<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>. |
5566 |
|
|
5567 |
|
</p> |
5568 |
|
<p>Note: Create effect sends on a sampler channel only when needed, because having effect |
5569 |
|
sends on a sampler channel will decrease runtime performance, because for implementing channel |
5570 |
|
effect sends, separate (sampler channel local) audio buffers are needed to render and mix |
5571 |
|
the voices and route the audio signal afterwards to the master outputs and effect send |
5572 |
|
outputs (along with their respective effect send levels). A sampler channel without effect |
5573 |
|
sends however can mix its voices directly into the audio output devices's audio buffers |
5574 |
|
and is thus faster. |
5575 |
|
|
5576 |
|
</p> |
5577 |
|
<p>Possible Answers: |
5578 |
|
</p> |
5579 |
|
<p> |
5580 |
|
</p> |
5581 |
|
<blockquote class="text"> |
5582 |
|
<p>"OK[<fx-send-id>]" - |
5583 |
|
</p> |
5584 |
|
<blockquote class="text"> |
5585 |
|
<p>in case a new effect send could be added to the |
5586 |
|
sampler channel, where <fx-send-id> reflects the |
5587 |
|
unique ID of the newly created effect send entity |
5588 |
|
</p> |
5589 |
|
</blockquote> |
5590 |
|
|
5591 |
|
|
5592 |
|
<p>"ERR:<error-code>:<error-message>" - |
5593 |
|
</p> |
5594 |
|
<blockquote class="text"> |
5595 |
|
<p>when a new effect send could not be added, i.e. |
5596 |
|
due to invalid parameters |
5597 |
|
</p> |
5598 |
|
</blockquote> |
5599 |
|
|
5600 |
|
|
5601 |
|
</blockquote><p> |
5602 |
|
|
5603 |
|
</p> |
5604 |
|
<p>Examples: |
5605 |
|
</p> |
5606 |
|
<p> |
5607 |
|
</p> |
5608 |
|
<blockquote class="text"> |
5609 |
|
<p>C: "CREATE FX_SEND 0 91 'Reverb Send'" |
5610 |
|
</p> |
5611 |
|
<p>S: "OK[0]" |
5612 |
|
</p> |
5613 |
|
</blockquote><p> |
5614 |
|
|
5615 |
|
</p> |
5616 |
|
<p> |
5617 |
|
</p> |
5618 |
|
<blockquote class="text"> |
5619 |
|
<p>C: "CREATE FX_SEND 0 93" |
5620 |
|
</p> |
5621 |
|
<p>S: "OK[1]" |
5622 |
|
</p> |
5623 |
|
</blockquote><p> |
5624 |
|
|
5625 |
|
</p> |
5626 |
|
<a name="DESTROY FX_SEND"></a><br /><hr /> |
5627 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5628 |
|
<a name="rfc.section.6.4.29"></a><h3>6.4.29. |
5629 |
|
Removing an effect send from a sampler channel</h3> |
5630 |
|
|
5631 |
|
<p>The front-end can remove an existing effect send on a specific sampler channel |
5632 |
|
by sending the following command: |
5633 |
|
</p> |
5634 |
|
<p> |
5635 |
|
</p> |
5636 |
|
<blockquote class="text"> |
5637 |
|
<p>DESTROY FX_SEND <sampler-channel> <fx-send-id> |
5638 |
|
</p> |
5639 |
|
</blockquote><p> |
5640 |
|
|
5641 |
|
</p> |
5642 |
|
<p>Where <sampler-channel> is the respective sampler channel |
5643 |
|
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> |
5644 |
|
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 |
5645 |
|
sampler channel from which the effect send should be removed from and |
5646 |
|
<fx-send-id> is the respective effect send number as returned by the |
5647 |
|
<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> |
5648 |
|
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. |
5649 |
|
</p> |
5650 |
|
<p>Possible Answers: |
5651 |
|
</p> |
5652 |
|
<p> |
5653 |
|
</p> |
5654 |
|
<blockquote class="text"> |
5655 |
|
<p>"OK" - |
5656 |
|
</p> |
5657 |
|
<blockquote class="text"> |
5658 |
|
<p>on success |
5659 |
|
</p> |
5660 |
|
</blockquote> |
5661 |
|
|
5662 |
|
|
5663 |
|
<p>"ERR:<error-code>:<error-message>" - |
5664 |
|
</p> |
5665 |
|
<blockquote class="text"> |
5666 |
|
<p>in case it failed, providing an appropriate error code and |
5667 |
|
error message |
5668 |
|
</p> |
5669 |
|
</blockquote> |
5670 |
|
|
5671 |
|
|
5672 |
|
</blockquote><p> |
5673 |
|
|
5674 |
|
</p> |
5675 |
|
<p>Example: |
5676 |
|
</p> |
5677 |
|
<p> |
5678 |
|
</p> |
5679 |
|
<blockquote class="text"> |
5680 |
|
<p>C: "DESTROY FX_SEND 0 0" |
5681 |
|
</p> |
5682 |
|
<p>S: "OK" |
5683 |
|
</p> |
5684 |
|
</blockquote><p> |
5685 |
|
|
5686 |
|
</p> |
5687 |
|
<a name="GET FX_SENDS"></a><br /><hr /> |
5688 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5689 |
|
<a name="rfc.section.6.4.30"></a><h3>6.4.30. |
5690 |
|
Getting amount of effect sends on a sampler channel</h3> |
5691 |
|
|
5692 |
|
<p>The front-end can ask for the amount of effect sends on a specific sampler channel |
5693 |
|
by sending the following command: |
5694 |
|
</p> |
5695 |
|
<p> |
5696 |
|
</p> |
5697 |
|
<blockquote class="text"> |
5698 |
|
<p>GET FX_SENDS <sampler-channel> |
5699 |
|
</p> |
5700 |
|
</blockquote><p> |
5701 |
|
|
5702 |
|
</p> |
5703 |
|
<p>Where <sampler-channel> is the respective sampler channel |
5704 |
|
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> |
5705 |
|
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. |
5706 |
|
</p> |
5707 |
|
<p>Possible Answers: |
5708 |
|
</p> |
5709 |
|
<p> |
5710 |
|
</p> |
5711 |
|
<blockquote class="text"> |
5712 |
|
<p>The sampler will answer by returning the number of effect |
5713 |
|
sends on the given sampler channel. |
5714 |
|
</p> |
5715 |
|
</blockquote><p> |
5716 |
|
|
5717 |
|
</p> |
5718 |
|
<p>Example: |
5719 |
|
</p> |
5720 |
|
<p> |
5721 |
|
</p> |
5722 |
|
<blockquote class="text"> |
5723 |
|
<p>C: "GET FX_SENDS 0" |
5724 |
|
</p> |
5725 |
|
<p>S: "2" |
5726 |
|
</p> |
5727 |
|
</blockquote><p> |
5728 |
|
|
5729 |
|
</p> |
5730 |
|
<a name="LIST FX_SENDS"></a><br /><hr /> |
5731 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5732 |
|
<a name="rfc.section.6.4.31"></a><h3>6.4.31. |
5733 |
|
Listing all effect sends on a sampler channel</h3> |
5734 |
|
|
5735 |
|
<p>The front-end can ask for a list of effect sends on a specific sampler channel |
5736 |
|
by sending the following command: |
5737 |
|
</p> |
5738 |
|
<p> |
5739 |
|
</p> |
5740 |
|
<blockquote class="text"> |
5741 |
|
<p>LIST FX_SENDS <sampler-channel> |
5742 |
|
</p> |
5743 |
|
</blockquote><p> |
5744 |
|
|
5745 |
|
</p> |
5746 |
|
<p>Where <sampler-channel> is the respective sampler channel |
5747 |
|
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> |
5748 |
|
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. |
5749 |
|
</p> |
5750 |
|
<p>Possible Answers: |
5751 |
|
</p> |
5752 |
|
<p> |
5753 |
|
</p> |
5754 |
|
<blockquote class="text"> |
5755 |
|
<p>The sampler will answer by returning a comma separated list |
5756 |
|
with all effect sends' numerical IDs on the given sampler |
5757 |
|
channel. |
5758 |
|
</p> |
5759 |
|
</blockquote><p> |
5760 |
|
|
5761 |
|
</p> |
5762 |
|
<p>Examples: |
5763 |
|
</p> |
5764 |
|
<p> |
5765 |
|
</p> |
5766 |
|
<blockquote class="text"> |
5767 |
|
<p>C: "LIST FX_SENDS 0" |
5768 |
|
</p> |
5769 |
|
<p>S: "0,1" |
5770 |
|
</p> |
5771 |
|
</blockquote><p> |
5772 |
|
|
5773 |
|
</p> |
5774 |
|
<p> |
5775 |
|
</p> |
5776 |
|
<blockquote class="text"> |
5777 |
|
<p>C: "LIST FX_SENDS 1" |
5778 |
|
</p> |
5779 |
|
<p>S: "" |
5780 |
|
</p> |
5781 |
|
</blockquote><p> |
5782 |
|
|
5783 |
|
</p> |
5784 |
|
<a name="GET FX_SEND INFO"></a><br /><hr /> |
5785 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5786 |
|
<a name="rfc.section.6.4.32"></a><h3>6.4.32. |
5787 |
|
Getting effect send information</h3> |
5788 |
|
|
5789 |
|
<p>The front-end can ask for the current settings of an effect send entity |
5790 |
|
by sending the following command: |
5791 |
|
</p> |
5792 |
|
<p> |
5793 |
|
</p> |
5794 |
|
<blockquote class="text"> |
5795 |
|
<p>GET FX_SEND INFO <sampler-channel> <fx-send-id> |
5796 |
|
</p> |
5797 |
|
</blockquote><p> |
5798 |
|
|
5799 |
|
</p> |
5800 |
|
<p>Where <sampler-channel> is the sampler channel number |
5801 |
|
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> |
5802 |
|
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 |
5803 |
|
<fx-send-id> reflects the numerical ID of the effect send entity |
5804 |
|
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> |
5805 |
|
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. |
5806 |
|
|
5807 |
|
</p> |
5808 |
|
<p>Possible Answers: |
5809 |
|
</p> |
5810 |
|
<p> |
5811 |
|
</p> |
5812 |
|
<blockquote class="text"> |
5813 |
|
<p>The sampler will answer by sending a <CRLF> separated list. |
5814 |
|
Each answer line begins with the settings category name |
5815 |
|
followed by a colon and then a space character <SP> and finally |
5816 |
|
the info character string to that setting category. At the |
5817 |
|
moment the following categories are defined: |
5818 |
|
</p> |
5819 |
|
<p> |
5820 |
|
</p> |
5821 |
|
<blockquote class="text"> |
5822 |
|
<p>NAME - |
5823 |
|
</p> |
5824 |
|
<blockquote class="text"> |
5825 |
|
<p>name of the effect send entity |
5826 |
|
(note that this character string may contain |
5827 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
5828 |
|
</p> |
5829 |
|
</blockquote> |
5830 |
|
|
5831 |
|
|
5832 |
|
<p>MIDI_CONTROLLER - |
5833 |
|
</p> |
5834 |
|
<blockquote class="text"> |
5835 |
|
<p>a value between 0 and 127 reflecting the MIDI controller |
5836 |
|
which is able to modify the effect send's send level |
5837 |
|
</p> |
5838 |
|
</blockquote> |
5839 |
|
|
5840 |
|
|
5841 |
|
<p>LEVEL - |
5842 |
|
</p> |
5843 |
|
<blockquote class="text"> |
5844 |
|
<p>optionally dotted number reflecting the effect send's |
5845 |
|
current send level (where a value < 1.0 means attenuation |
5846 |
|
and a value > 1.0 means amplification) |
5847 |
|
</p> |
5848 |
|
</blockquote> |
5849 |
|
|
5850 |
|
|
5851 |
|
<p>AUDIO_OUTPUT_ROUTING - |
5852 |
|
</p> |
5853 |
|
<blockquote class="text"> |
5854 |
|
<p>comma separated list which reflects to which audio |
5855 |
|
channel of the selected audio output device each |
5856 |
|
effect send output channel is routed to, e.g. "0,3" would |
5857 |
|
mean the effect send's output channel 0 is routed to channel |
5858 |
|
0 of the audio output device and the effect send's output |
5859 |
|
channel 1 is routed to the channel 3 of the audio |
5860 |
|
output device (see |
5861 |
|
<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> |
5862 |
|
for details), if an internal send |
5863 |
|
effect is assigned to the effect |
5864 |
|
send, then this setting defines the |
5865 |
|
audio channel routing to that |
5866 |
|
effect instance respectively |
5867 |
|
</p> |
5868 |
|
</blockquote> |
5869 |
|
|
5870 |
|
|
5871 |
|
<p>EFFECT - |
5872 |
|
</p> |
5873 |
|
<blockquote class="text"> |
5874 |
|
<p>destination send effect chain ID |
5875 |
|
and destination effect chain |
5876 |
|
position, separated by comma in the |
5877 |
|
form "<effect-chain>,<chain-pos>" |
5878 |
|
or "NONE" if there is no send effect |
5879 |
|
assigned to the effect send |
5880 |
|
</p> |
5881 |
|
</blockquote> |
5882 |
|
|
5883 |
|
|
5884 |
|
</blockquote> |
5885 |
|
|
5886 |
|
|
5887 |
|
</blockquote><p> |
5888 |
|
|
5889 |
|
</p> |
5890 |
|
<p>The mentioned fields above don't have to be in particular order. |
5891 |
|
</p> |
5892 |
|
<p>Example: |
5893 |
|
</p> |
5894 |
|
<p> |
5895 |
|
</p> |
5896 |
|
<blockquote class="text"> |
5897 |
|
<p>C: "GET FX_SEND INFO 0 0" |
5898 |
|
</p> |
5899 |
|
<p>S: "NAME: Reverb Send" |
5900 |
|
</p> |
5901 |
|
<p> "MIDI_CONTROLLER: 91" |
5902 |
|
</p> |
5903 |
|
<p> "LEVEL: 0.3" |
5904 |
|
</p> |
5905 |
|
<p> "AUDIO_OUTPUT_ROUTING: 2,3" |
5906 |
|
</p> |
5907 |
|
<p> "EFFECT: NONE" |
5908 |
|
</p> |
5909 |
|
<p> "." |
5910 |
|
</p> |
5911 |
|
</blockquote><p> |
5912 |
|
|
5913 |
|
</p> |
5914 |
|
<p> |
5915 |
|
</p> |
5916 |
|
<blockquote class="text"> |
5917 |
|
<p>C: "GET FX_SEND INFO 0 1" |
5918 |
|
</p> |
5919 |
|
<p>S: "NAME: Delay Send (Internal)" |
5920 |
|
</p> |
5921 |
|
<p> "MIDI_CONTROLLER: 93" |
5922 |
|
</p> |
5923 |
|
<p> "LEVEL: 0.51" |
5924 |
|
</p> |
5925 |
|
<p> "AUDIO_OUTPUT_ROUTING: 1,2" |
5926 |
|
</p> |
5927 |
|
<p> "EFFECT: 2,0" |
5928 |
|
</p> |
5929 |
|
<p> "." |
5930 |
|
</p> |
5931 |
|
</blockquote><p> |
5932 |
|
|
5933 |
|
</p> |
5934 |
|
<a name="SET FX_SEND NAME"></a><br /><hr /> |
5935 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
5936 |
|
<a name="rfc.section.6.4.33"></a><h3>6.4.33. |
5937 |
|
Changing effect send's name</h3> |
5938 |
|
|
5939 |
|
<p>The front-end can alter the current name of an effect |
5940 |
|
send entity by sending the following command: |
5941 |
|
</p> |
5942 |
|
<p> |
5943 |
|
</p> |
5944 |
|
<blockquote class="text"> |
5945 |
|
<p>SET FX_SEND NAME <sampler-chan> <fx-send-id> <name> |
5946 |
|
</p> |
5947 |
|
</blockquote><p> |
5948 |
|
|
5949 |
|
</p> |
5950 |
|
<p>Where <sampler-chan> is the sampler channel number |
5951 |
|
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> |
5952 |
|
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, |
5953 |
|
<fx-send-id> reflects the numerical ID of the effect send entity |
5954 |
|
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> |
5955 |
|
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 and |
5956 |
|
<name> is the new name of the effect send entity, which |
5957 |
|
does not have to be unique (name MUST be encapsulated into apostrophes |
5958 |
|
and supports escape sequences as described in chapter |
5959 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
5960 |
|
|
5961 |
|
</p> |
5962 |
|
<p>Possible Answers: |
5963 |
|
</p> |
5964 |
|
<p> |
5965 |
|
</p> |
5966 |
|
<blockquote class="text"> |
5967 |
|
<p>"OK" - |
5968 |
|
</p> |
5969 |
|
<blockquote class="text"> |
5970 |
|
<p>on success |
5971 |
|
</p> |
5972 |
|
</blockquote> |
5973 |
|
|
5974 |
|
|
5975 |
|
<p>"ERR:<error-code>:<error-message>" - |
5976 |
|
</p> |
5977 |
|
<blockquote class="text"> |
5978 |
|
<p>in case it failed, providing an appropriate error code and error message |
5979 |
|
</p> |
5980 |
|
</blockquote> |
5981 |
|
|
5982 |
|
|
5983 |
|
</blockquote><p> |
5984 |
|
|
5985 |
|
</p> |
5986 |
|
<p>Example: |
5987 |
|
</p> |
5988 |
|
<p> |
5989 |
|
</p> |
5990 |
|
<blockquote class="text"> |
5991 |
|
<p>C: "SET FX_SEND NAME 0 0 'Fx Send 1'" |
5992 |
|
</p> |
5993 |
|
<p>S: "OK" |
5994 |
|
</p> |
5995 |
|
</blockquote><p> |
5996 |
|
|
5997 |
|
</p> |
5998 |
|
<a name="SET FX_SEND AUDIO_OUTPUT_CHANNEL"></a><br /><hr /> |
5999 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6000 |
|
<a name="rfc.section.6.4.34"></a><h3>6.4.34. |
6001 |
|
Altering effect send's audio routing</h3> |
6002 |
|
|
6003 |
|
<p>The front-end can alter the destination of an effect send's audio channel on a specific |
6004 |
|
sampler channel by sending the following command: |
6005 |
|
</p> |
6006 |
|
<p> |
6007 |
|
</p> |
6008 |
|
<blockquote class="text"> |
6009 |
|
<p>SET FX_SEND AUDIO_OUTPUT_CHANNEL <sampler-chan> <fx-send-id> <audio-src> <audio-dst> |
6010 |
|
</p> |
6011 |
|
</blockquote><p> |
6012 |
|
|
6013 |
|
</p> |
6014 |
|
<p>Where <sampler-chan> is the sampler channel number |
6015 |
|
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> |
6016 |
|
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, |
6017 |
|
<fx-send-id> reflects the numerical ID of the effect send entity |
6018 |
|
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> |
6019 |
|
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, |
6020 |
|
<audio-src> is the numerical ID of the effect send's audio channel |
6021 |
|
which should be rerouted and <audio-dst> is the numerical ID of |
6022 |
|
the audio channel of the selected audio output device where <audio-src> |
6023 |
|
should be routed to. If an internal send effect is assigned |
6024 |
|
to the effect send, then this setting defines the audio |
6025 |
|
channel routing to that effect instance respectively. |
6026 |
|
</p> |
6027 |
|
<p>Note that effect sends can only route audio to the same audio output |
6028 |
|
device as assigned to the effect send's sampler channel. Also note that an |
6029 |
|
effect send entity does always have exactly as much audio channels as its |
6030 |
|
sampler channel. So if the sampler channel is stereo, the effect send does |
6031 |
|
have two audio channels as well. Also keep in mind that the amount of audio |
6032 |
|
channels on a sampler channel might be dependant not only to the deployed |
6033 |
|
sampler engine on the sampler channel, but also dependant to the instrument |
6034 |
|
currently loaded. However you can (effectively) turn an i.e. stereo effect |
6035 |
|
send into a mono one by simply altering its audio routing appropriately. |
6036 |
|
</p> |
6037 |
|
<p>Possible Answers: |
6038 |
|
</p> |
6039 |
|
<p> |
6040 |
|
</p> |
6041 |
|
<blockquote class="text"> |
6042 |
|
<p>"OK" - |
6043 |
|
</p> |
6044 |
|
<blockquote class="text"> |
6045 |
|
<p>on success |
6046 |
|
</p> |
6047 |
|
</blockquote> |
6048 |
|
|
6049 |
|
|
6050 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
6051 |
|
</p> |
6052 |
|
<blockquote class="text"> |
6053 |
|
<p>if audio output channel was set, but there are noteworthy |
6054 |
|
issue(s) related, providing an appropriate warning code and |
6055 |
|
warning message |
6056 |
|
</p> |
6057 |
|
</blockquote> |
6058 |
|
|
6059 |
|
|
6060 |
|
<p>"ERR:<error-code>:<error-message>" - |
6061 |
|
</p> |
6062 |
|
<blockquote class="text"> |
6063 |
|
<p>in case it failed, providing an appropriate error code and error message |
6064 |
|
</p> |
6065 |
|
</blockquote> |
6066 |
|
|
6067 |
|
|
6068 |
|
</blockquote><p> |
6069 |
|
|
6070 |
|
</p> |
6071 |
|
<p>Example: |
6072 |
|
</p> |
6073 |
|
<p> |
6074 |
|
</p> |
6075 |
|
<blockquote class="text"> |
6076 |
|
<p>C: "SET FX_SEND AUDIO_OUTPUT_CHANNEL 0 0 0 2" |
6077 |
|
</p> |
6078 |
|
<p>S: "OK" |
6079 |
|
</p> |
6080 |
|
</blockquote><p> |
6081 |
|
|
6082 |
|
</p> |
6083 |
|
<a name="SET FX_SEND EFFECT"></a><br /><hr /> |
6084 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6085 |
|
<a name="rfc.section.6.4.35"></a><h3>6.4.35. |
6086 |
|
Assigning destination effect to an effect send</h3> |
6087 |
|
|
6088 |
|
<p>The front-end can (re-)assign a destination effect to an |
6089 |
|
effect send by sending the following command: |
6090 |
|
</p> |
6091 |
|
<p> |
6092 |
|
</p> |
6093 |
|
<blockquote class="text"> |
6094 |
|
<p>SET FX_SEND EFFECT <sampler-chan> <fx-send-id> <effect-chain> <chain-pos> |
6095 |
|
</p> |
6096 |
|
</blockquote><p> |
6097 |
|
|
6098 |
|
</p> |
6099 |
|
<p>Where <sampler-chan> is the sampler channel number |
6100 |
|
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> |
6101 |
|
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, |
6102 |
|
<fx-send-id> reflects the numerical ID of the effect send entity |
6103 |
|
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> |
6104 |
|
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, |
6105 |
|
<effect-chain> by the numerical ID of the destination |
6106 |
|
effect chain as returned by the |
6107 |
|
<a class='info' href='#ADD SEND_EFFECT_CHAIN'>"ADD SEND_EFFECT_CHAIN"<span> (</span><span class='info'>Add send effect chain</span><span>)</span></a> |
6108 |
|
or |
6109 |
|
<a class='info' href='#LIST SEND_EFFECT_CHAINS'>"LIST SEND_EFFECT_CHAINS"<span> (</span><span class='info'>Retrieve list of send effect chains</span><span>)</span></a> |
6110 |
|
command and <chain-pos> reflects the exact effect |
6111 |
|
chain position in the effect chain which hosts the actual |
6112 |
|
destination effect. |
6113 |
|
</p> |
6114 |
|
<p>Possible Answers: |
6115 |
|
</p> |
6116 |
|
<p> |
6117 |
|
</p> |
6118 |
|
<blockquote class="text"> |
6119 |
|
<p>"OK" - |
6120 |
|
</p> |
6121 |
|
<blockquote class="text"> |
6122 |
|
<p>on success |
6123 |
|
</p> |
6124 |
|
</blockquote> |
6125 |
|
|
6126 |
|
|
6127 |
|
<p>"ERR:<error-code>:<error-message>" - |
6128 |
|
</p> |
6129 |
|
<blockquote class="text"> |
6130 |
|
<p>in case it failed, providing an appropriate error code and error message |
6131 |
|
</p> |
6132 |
|
</blockquote> |
6133 |
|
|
6134 |
|
|
6135 |
|
</blockquote><p> |
6136 |
|
|
6137 |
|
</p> |
6138 |
|
<p>Example: |
6139 |
|
</p> |
6140 |
|
<p> |
6141 |
|
</p> |
6142 |
|
<blockquote class="text"> |
6143 |
|
<p>C: "SET FX_SEND EFFECT 0 0 2 5" |
6144 |
|
</p> |
6145 |
|
<p>S: "OK" |
6146 |
|
</p> |
6147 |
|
</blockquote><p> |
6148 |
|
|
6149 |
|
</p> |
6150 |
|
<a name="REMOVE FX_SEND EFFECT"></a><br /><hr /> |
6151 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6152 |
|
<a name="rfc.section.6.4.36"></a><h3>6.4.36. |
6153 |
|
Removing destination effect from an effect send</h3> |
6154 |
|
|
6155 |
|
<p>The front-end can (re-)assign a destination effect to an |
6156 |
|
effect send by sending the following command: |
6157 |
|
</p> |
6158 |
|
<p> |
6159 |
|
</p> |
6160 |
|
<blockquote class="text"> |
6161 |
|
<p>REMOVE FX_SEND EFFECT <sampler-chan> <fx-send-id> |
6162 |
|
</p> |
6163 |
|
</blockquote><p> |
6164 |
|
|
6165 |
|
</p> |
6166 |
|
<p>Where <sampler-chan> is the sampler channel number |
6167 |
|
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> |
6168 |
|
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, |
6169 |
|
<fx-send-id> reflects the numerical ID of the effect send entity |
6170 |
|
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> |
6171 |
|
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. |
6172 |
|
</p> |
6173 |
|
<p>After the destination effect has been removed from the |
6174 |
|
effect send, the audio signal of the effect send will be |
6175 |
|
routed directly to the audio output device, according to the |
6176 |
|
audio channel routing setting of the effect send. |
6177 |
|
|
6178 |
|
</p> |
6179 |
|
<p>Possible Answers: |
6180 |
|
</p> |
6181 |
|
<p> |
6182 |
|
</p> |
6183 |
|
<blockquote class="text"> |
6184 |
|
<p>"OK" - |
6185 |
|
</p> |
6186 |
|
<blockquote class="text"> |
6187 |
|
<p>on success |
6188 |
|
</p> |
6189 |
|
</blockquote> |
6190 |
|
|
6191 |
|
|
6192 |
|
<p>"ERR:<error-code>:<error-message>" - |
6193 |
|
</p> |
6194 |
|
<blockquote class="text"> |
6195 |
|
<p>in case it failed, providing an appropriate error code and error message |
6196 |
|
</p> |
6197 |
|
</blockquote> |
6198 |
|
|
6199 |
|
|
6200 |
|
</blockquote><p> |
6201 |
|
|
6202 |
|
</p> |
6203 |
|
<p>Example: |
6204 |
|
</p> |
6205 |
|
<p> |
6206 |
|
</p> |
6207 |
|
<blockquote class="text"> |
6208 |
|
<p>C: "REMOVE FX_SEND EFFECT 0 0" |
6209 |
|
</p> |
6210 |
|
<p>S: "OK" |
6211 |
|
</p> |
6212 |
|
</blockquote><p> |
6213 |
|
|
6214 |
|
</p> |
6215 |
|
<a name="SET FX_SEND MIDI_CONTROLLER"></a><br /><hr /> |
6216 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6217 |
|
<a name="rfc.section.6.4.37"></a><h3>6.4.37. |
6218 |
|
Altering effect send's MIDI controller</h3> |
6219 |
|
|
6220 |
|
<p>The front-end can alter the MIDI controller of an effect |
6221 |
|
send entity by sending the following command: |
6222 |
|
</p> |
6223 |
|
<p> |
6224 |
|
</p> |
6225 |
|
<blockquote class="text"> |
6226 |
|
<p>SET FX_SEND MIDI_CONTROLLER <sampler-chan> <fx-send-id> <midi-ctrl> |
6227 |
|
</p> |
6228 |
|
</blockquote><p> |
6229 |
|
|
6230 |
|
</p> |
6231 |
|
<p>Where <sampler-chan> is the sampler channel number |
6232 |
|
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> |
6233 |
|
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, |
6234 |
|
<fx-send-id> reflects the numerical ID of the effect send entity |
6235 |
|
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> |
6236 |
|
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 and |
6237 |
|
<midi-ctrl> reflects the MIDI controller which shall be |
6238 |
|
able to modify the effect send's send level. |
6239 |
|
</p> |
6240 |
|
<p>Possible Answers: |
6241 |
|
</p> |
6242 |
|
<p> |
6243 |
|
</p> |
6244 |
|
<blockquote class="text"> |
6245 |
|
<p>"OK" - |
6246 |
|
</p> |
6247 |
|
<blockquote class="text"> |
6248 |
|
<p>on success |
6249 |
|
</p> |
6250 |
|
</blockquote> |
6251 |
|
|
6252 |
|
|
6253 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
6254 |
|
</p> |
6255 |
|
<blockquote class="text"> |
6256 |
|
<p>if MIDI controller was set, but there are noteworthy |
6257 |
|
issue(s) related, providing an appropriate warning code and |
6258 |
|
warning message |
6259 |
|
</p> |
6260 |
|
</blockquote> |
6261 |
|
|
6262 |
|
|
6263 |
|
<p>"ERR:<error-code>:<error-message>" - |
6264 |
|
</p> |
6265 |
|
<blockquote class="text"> |
6266 |
|
<p>in case it failed, providing an appropriate error code and error message |
6267 |
|
</p> |
6268 |
|
</blockquote> |
6269 |
|
|
6270 |
|
|
6271 |
|
</blockquote><p> |
6272 |
|
|
6273 |
|
</p> |
6274 |
|
<p>Example: |
6275 |
|
</p> |
6276 |
|
<p> |
6277 |
|
</p> |
6278 |
|
<blockquote class="text"> |
6279 |
|
<p>C: "SET FX_SEND MIDI_CONTROLLER 0 0 91" |
6280 |
|
</p> |
6281 |
|
<p>S: "OK" |
6282 |
|
</p> |
6283 |
|
</blockquote><p> |
6284 |
|
|
6285 |
|
</p> |
6286 |
|
<a name="SET FX_SEND LEVEL"></a><br /><hr /> |
6287 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6288 |
|
<a name="rfc.section.6.4.38"></a><h3>6.4.38. |
6289 |
|
Altering effect send's send level</h3> |
6290 |
|
|
6291 |
|
<p>The front-end can alter the current send level of an effect |
6292 |
|
send entity by sending the following command: |
6293 |
|
</p> |
6294 |
|
<p> |
6295 |
|
</p> |
6296 |
|
<blockquote class="text"> |
6297 |
|
<p>SET FX_SEND LEVEL <sampler-chan> <fx-send-id> <volume> |
6298 |
|
</p> |
6299 |
|
</blockquote><p> |
6300 |
|
|
6301 |
|
</p> |
6302 |
|
<p>Where <sampler-chan> is the sampler channel number |
6303 |
|
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> |
6304 |
|
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, |
6305 |
|
<fx-send-id> reflects the numerical ID of the effect send entity |
6306 |
|
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> |
6307 |
|
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 and |
6308 |
|
<volume> is an optionally dotted positive number (a value |
6309 |
|
smaller than 1.0 means attenuation, whereas a value greater than |
6310 |
|
1.0 means amplification) reflecting the new send level. |
6311 |
|
</p> |
6312 |
|
<p>Possible Answers: |
6313 |
|
</p> |
6314 |
|
<p> |
6315 |
|
</p> |
6316 |
|
<blockquote class="text"> |
6317 |
|
<p>"OK" - |
6318 |
|
</p> |
6319 |
|
<blockquote class="text"> |
6320 |
|
<p>on success |
6321 |
|
</p> |
6322 |
|
</blockquote> |
6323 |
|
|
6324 |
|
|
6325 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
6326 |
|
</p> |
6327 |
|
<blockquote class="text"> |
6328 |
|
<p>if new send level was set, but there are noteworthy |
6329 |
|
issue(s) related, providing an appropriate warning code and |
6330 |
|
warning message |
6331 |
|
</p> |
6332 |
|
</blockquote> |
6333 |
|
|
6334 |
|
|
6335 |
|
<p>"ERR:<error-code>:<error-message>" - |
6336 |
|
</p> |
6337 |
|
<blockquote class="text"> |
6338 |
|
<p>in case it failed, providing an appropriate error code and error message |
6339 |
|
</p> |
6340 |
|
</blockquote> |
6341 |
|
|
6342 |
|
|
6343 |
|
</blockquote><p> |
6344 |
|
|
6345 |
|
</p> |
6346 |
|
<p>Example: |
6347 |
|
</p> |
6348 |
|
<p> |
6349 |
|
</p> |
6350 |
|
<blockquote class="text"> |
6351 |
|
<p>C: "SET FX_SEND LEVEL 0 0 0.15" |
6352 |
|
</p> |
6353 |
|
<p>S: "OK" |
6354 |
|
</p> |
6355 |
|
</blockquote><p> |
6356 |
|
|
6357 |
|
</p> |
6358 |
|
<a name="SEND CHANNEL MIDI_DATA"></a><br /><hr /> |
6359 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6360 |
|
<a name="rfc.section.6.4.39"></a><h3>6.4.39. |
6361 |
|
Sending MIDI messages to sampler channel</h3> |
6362 |
|
|
6363 |
|
<p>The front-end can send MIDI events to a specific sampler channel |
6364 |
|
by sending the following command: |
6365 |
|
</p> |
6366 |
|
<p> |
6367 |
|
</p> |
6368 |
|
<blockquote class="text"> |
6369 |
|
<p>SEND CHANNEL MIDI_DATA <midi-msg> <sampler-chan> <arg1> <arg2> |
6370 |
|
</p> |
6371 |
|
</blockquote><p> |
6372 |
|
|
6373 |
|
</p> |
6374 |
|
<p>Where <sampler-chan> is the sampler channel number |
6375 |
|
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> |
6376 |
|
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, |
6377 |
|
<arg1> and <arg2> arguments depend on the <midi-msg> argument, which |
6378 |
|
specifies the MIDI message type. Currently, the following MIDI messages are supported: |
6379 |
|
</p> |
6380 |
|
<p> |
6381 |
|
</p> |
6382 |
|
<blockquote class="text"> |
6383 |
|
<p>"NOTE_ON" - |
6384 |
|
</p> |
6385 |
|
<blockquote class="text"> |
6386 |
|
<p>For turning on MIDI notes, where <arg1> |
6387 |
|
specifies the key number and <arg2> the velocity |
6388 |
|
as described in the MIDI specification. |
6389 |
|
</p> |
6390 |
|
</blockquote> |
6391 |
|
|
6392 |
|
|
6393 |
|
<p>"NOTE_OFF" - |
6394 |
|
</p> |
6395 |
|
<blockquote class="text"> |
6396 |
|
<p>For turning a currently playing MIDI note off, where <arg1> |
6397 |
|
specifies the key number and <arg2> the velocity |
6398 |
|
as described in the MIDI specification. |
6399 |
|
</p> |
6400 |
|
</blockquote> |
6401 |
|
|
6402 |
|
|
6403 |
|
<p>"CC" - |
6404 |
|
</p> |
6405 |
|
<blockquote class="text"> |
6406 |
|
<p>For changing a MIDI controller, where <arg1> |
6407 |
|
specifies the controller number and <arg2> the |
6408 |
|
new value of the controller as described in the Control |
6409 |
|
Change section of the MIDI specification. |
6410 |
|
</p> |
6411 |
|
</blockquote> |
6412 |
|
|
6413 |
|
|
6414 |
|
</blockquote><p> |
6415 |
|
|
6416 |
|
</p> |
6417 |
|
<p>CAUTION: This command is provided for implementations of virtual MIDI keyboards |
6418 |
|
and no realtime guarantee whatsoever will be made! |
6419 |
|
</p> |
6420 |
|
<p>Possible Answers: |
6421 |
|
</p> |
6422 |
|
<p> |
6423 |
|
</p> |
6424 |
|
<blockquote class="text"> |
6425 |
|
<p>"OK" - |
6426 |
|
</p> |
6427 |
|
<blockquote class="text"> |
6428 |
|
<p>on success |
6429 |
|
</p> |
6430 |
|
</blockquote> |
6431 |
|
|
6432 |
|
|
6433 |
|
<p>"ERR:<error-code>:<error-message>" - |
6434 |
|
</p> |
6435 |
|
<blockquote class="text"> |
6436 |
|
<p>in case it failed, providing an appropriate error code and error message |
6437 |
|
</p> |
6438 |
|
</blockquote> |
6439 |
|
|
6440 |
|
|
6441 |
|
</blockquote><p> |
6442 |
|
|
6443 |
|
</p> |
6444 |
|
<p>Example: |
6445 |
|
</p> |
6446 |
|
<p> |
6447 |
|
</p> |
6448 |
|
<blockquote class="text"> |
6449 |
|
<p>C: "SEND CHANNEL MIDI_DATA NOTE_ON 0 56 112" |
6450 |
|
</p> |
6451 |
|
<p>S: "OK" |
6452 |
|
</p> |
6453 |
|
</blockquote><p> |
6454 |
|
|
6455 |
|
</p> |
6456 |
<a name="RESET CHANNEL"></a><br /><hr /> |
<a name="RESET CHANNEL"></a><br /><hr /> |
6457 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6458 |
<a name="rfc.section.6.4.25"></a><h3>6.4.25. |
<a name="rfc.section.6.4.40"></a><h3>6.4.40. |
6459 |
Resetting a sampler channel</h3> |
Resetting a sampler channel</h3> |
6460 |
|
|
6461 |
<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: |
6790 |
</blockquote><p> |
</blockquote><p> |
6791 |
|
|
6792 |
</p> |
</p> |
6793 |
<a name="RESET"></a><br /><hr /> |
<a name="GET TOTAL_STREAM_COUNT"></a><br /><hr /> |
6794 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6795 |
<a name="rfc.section.6.6.3"></a><h3>6.6.3. |
<a name="rfc.section.6.6.3"></a><h3>6.6.3. |
6796 |
|
Current number of active disk streams</h3> |
6797 |
|
|
6798 |
|
<p>The front-end can ask for the current number of active disk streams on |
6799 |
|
the sampler by sending the following command: |
6800 |
|
</p> |
6801 |
|
<p> |
6802 |
|
</p> |
6803 |
|
<blockquote class="text"> |
6804 |
|
<p>GET TOTAL_STREAM_COUNT |
6805 |
|
</p> |
6806 |
|
</blockquote><p> |
6807 |
|
|
6808 |
|
</p> |
6809 |
|
<p>Possible Answers: |
6810 |
|
</p> |
6811 |
|
<p> |
6812 |
|
</p> |
6813 |
|
<blockquote class="text"> |
6814 |
|
<p>LinuxSampler will answer by returning the number of all active |
6815 |
|
disk streams on the sampler. |
6816 |
|
</p> |
6817 |
|
</blockquote><p> |
6818 |
|
|
6819 |
|
</p> |
6820 |
|
<a name="RESET"></a><br /><hr /> |
6821 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6822 |
|
<a name="rfc.section.6.6.4"></a><h3>6.6.4. |
6823 |
Reset sampler</h3> |
Reset sampler</h3> |
6824 |
|
|
6825 |
<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: |
6860 |
</p> |
</p> |
6861 |
<a name="GET SERVER INFO"></a><br /><hr /> |
<a name="GET SERVER INFO"></a><br /><hr /> |
6862 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6863 |
<a name="rfc.section.6.6.4"></a><h3>6.6.4. |
<a name="rfc.section.6.6.5"></a><h3>6.6.5. |
6864 |
General sampler informations</h3> |
General sampler informations</h3> |
6865 |
|
|
6866 |
<p>The client can ask for general informations about the LinuxSampler |
<p>The client can ask for general informations about the LinuxSampler |
6893 |
</p> |
</p> |
6894 |
<blockquote class="text"> |
<blockquote class="text"> |
6895 |
<p>arbitrary textual description about the sampler |
<p>arbitrary textual description about the sampler |
6896 |
|
(note that the character string may contain |
6897 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
6898 |
</p> |
</p> |
6899 |
</blockquote> |
</blockquote> |
6900 |
|
|
6916 |
</blockquote> |
</blockquote> |
6917 |
|
|
6918 |
|
|
6919 |
|
<p>INSTRUMENTS_DB_SUPPORT - |
6920 |
|
</p> |
6921 |
|
<blockquote class="text"> |
6922 |
|
<p>either yes or no, specifies whether the |
6923 |
|
sampler is build with instruments database support. |
6924 |
|
</p> |
6925 |
|
</blockquote> |
6926 |
|
|
6927 |
|
|
6928 |
</blockquote> |
</blockquote> |
6929 |
|
|
6930 |
|
|
6934 |
<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. |
6935 |
Other fields might be added in future. |
Other fields might be added in future. |
6936 |
</p> |
</p> |
6937 |
|
<p>Example: |
6938 |
|
</p> |
6939 |
|
<p> |
6940 |
|
</p> |
6941 |
|
<blockquote class="text"> |
6942 |
|
<p>C: "GET SERVER INFO" |
6943 |
|
</p> |
6944 |
|
<p>S: "DESCRIPTION: LinuxSampler - modular, streaming capable sampler" |
6945 |
|
</p> |
6946 |
|
<p> "VERSION: 1.0.0.svn23" |
6947 |
|
</p> |
6948 |
|
<p> "PROTOCOL_VERSION: 1.5" |
6949 |
|
</p> |
6950 |
|
<p> "INSTRUMENTS_DB_SUPPORT: no" |
6951 |
|
</p> |
6952 |
|
<p> "." |
6953 |
|
</p> |
6954 |
|
</blockquote><p> |
6955 |
|
|
6956 |
|
</p> |
6957 |
|
<a name="GET VOLUME"></a><br /><hr /> |
6958 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6959 |
|
<a name="rfc.section.6.6.6"></a><h3>6.6.6. |
6960 |
|
Getting global volume attenuation</h3> |
6961 |
|
|
6962 |
|
<p>The client can ask for the current global sampler-wide volume |
6963 |
|
attenuation by sending the following command: |
6964 |
|
</p> |
6965 |
|
<p> |
6966 |
|
</p> |
6967 |
|
<blockquote class="text"> |
6968 |
|
<p>GET VOLUME |
6969 |
|
</p> |
6970 |
|
</blockquote><p> |
6971 |
|
|
6972 |
|
</p> |
6973 |
|
<p>Possible Answers: |
6974 |
|
</p> |
6975 |
|
<p> |
6976 |
|
</p> |
6977 |
|
<blockquote class="text"> |
6978 |
|
<p>The sampler will always answer by returning the optional |
6979 |
|
dotted floating point coefficient, reflecting the current |
6980 |
|
global volume attenuation. |
6981 |
|
|
6982 |
|
</p> |
6983 |
|
</blockquote><p> |
6984 |
|
|
6985 |
|
</p> |
6986 |
|
<p>Note: it is up to the respective sampler engine whether to obey |
6987 |
|
that global volume parameter or not, but in general all engines SHOULD |
6988 |
|
use this parameter. |
6989 |
|
</p> |
6990 |
|
<a name="SET VOLUME"></a><br /><hr /> |
6991 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
6992 |
|
<a name="rfc.section.6.6.7"></a><h3>6.6.7. |
6993 |
|
Setting global volume attenuation</h3> |
6994 |
|
|
6995 |
|
<p>The client can alter the current global sampler-wide volume |
6996 |
|
attenuation by sending the following command: |
6997 |
|
</p> |
6998 |
|
<p> |
6999 |
|
</p> |
7000 |
|
<blockquote class="text"> |
7001 |
|
<p>SET VOLUME <volume> |
7002 |
|
</p> |
7003 |
|
</blockquote><p> |
7004 |
|
|
7005 |
|
</p> |
7006 |
|
<p>Where <volume> should be replaced by the optional dotted |
7007 |
|
floating point value, reflecting the new global volume parameter. |
7008 |
|
This value might usually be in the range between 0.0 and 1.0, that |
7009 |
|
is for attenuating the overall volume. |
7010 |
|
</p> |
7011 |
|
<p>Possible Answers: |
7012 |
|
</p> |
7013 |
|
<p> |
7014 |
|
</p> |
7015 |
|
<blockquote class="text"> |
7016 |
|
<p>"OK" - |
7017 |
|
</p> |
7018 |
|
<blockquote class="text"> |
7019 |
|
<p>on success |
7020 |
|
</p> |
7021 |
|
</blockquote> |
7022 |
|
|
7023 |
|
|
7024 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
7025 |
|
</p> |
7026 |
|
<blockquote class="text"> |
7027 |
|
<p>if the global volume was set, but there are noteworthy |
7028 |
|
issue(s) related, providing an appropriate warning code and |
7029 |
|
warning message |
7030 |
|
</p> |
7031 |
|
</blockquote> |
7032 |
|
|
7033 |
|
|
7034 |
|
<p>"ERR:<error-code>:<error-message>" - |
7035 |
|
</p> |
7036 |
|
<blockquote class="text"> |
7037 |
|
<p>in case it failed, providing an appropriate error code and error message |
7038 |
|
</p> |
7039 |
|
</blockquote> |
7040 |
|
|
7041 |
|
|
7042 |
|
</blockquote><p> |
7043 |
|
|
7044 |
|
</p> |
7045 |
|
<a name="GET VOICES"></a><br /><hr /> |
7046 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7047 |
|
<a name="rfc.section.6.6.8"></a><h3>6.6.8. |
7048 |
|
Getting global voice limit</h3> |
7049 |
|
|
7050 |
|
<p>The client can ask for the current global sampler-wide limit |
7051 |
|
for maximum voices by sending the following command: |
7052 |
|
</p> |
7053 |
|
<p> |
7054 |
|
</p> |
7055 |
|
<blockquote class="text"> |
7056 |
|
<p>GET VOICES |
7057 |
|
</p> |
7058 |
|
</blockquote><p> |
7059 |
|
|
7060 |
|
</p> |
7061 |
|
<p>Possible Answers: |
7062 |
|
</p> |
7063 |
|
<p> |
7064 |
|
</p> |
7065 |
|
<blockquote class="text"> |
7066 |
|
<p>LinuxSampler will answer by returning the number for |
7067 |
|
the current limit of maximum voices. |
7068 |
|
</p> |
7069 |
|
</blockquote><p> |
7070 |
|
|
7071 |
|
</p> |
7072 |
|
<p>The voice limit setting defines how many voices should maximum |
7073 |
|
be processed by the sampler at the same time. If the user |
7074 |
|
triggers new notes which would exceed that voice limit, the |
7075 |
|
sampler engine will react by stealing old voices for those |
7076 |
|
newly triggered notes. Note that the amount of voices triggered |
7077 |
|
by a new note can be larger than one and is dependent to the |
7078 |
|
respective instrument and probably further criterias. |
7079 |
|
</p> |
7080 |
|
<a name="SET VOICES"></a><br /><hr /> |
7081 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7082 |
|
<a name="rfc.section.6.6.9"></a><h3>6.6.9. |
7083 |
|
Setting global voice limit</h3> |
7084 |
|
|
7085 |
|
<p>The client can alter the current global sampler-wide limit |
7086 |
|
for maximum voices by sending the following command: |
7087 |
|
</p> |
7088 |
|
<p> |
7089 |
|
</p> |
7090 |
|
<blockquote class="text"> |
7091 |
|
<p>SET VOICES <max-voices> |
7092 |
|
</p> |
7093 |
|
</blockquote><p> |
7094 |
|
|
7095 |
|
</p> |
7096 |
|
<p>Where <max-voices> should be replaced by the integer |
7097 |
|
value, reflecting the new global amount limit of maximum voices. |
7098 |
|
This value has to be larger than 0. |
7099 |
|
</p> |
7100 |
|
<p>Possible Answers: |
7101 |
|
</p> |
7102 |
|
<p> |
7103 |
|
</p> |
7104 |
|
<blockquote class="text"> |
7105 |
|
<p>"OK" - |
7106 |
|
</p> |
7107 |
|
<blockquote class="text"> |
7108 |
|
<p>on success |
7109 |
|
</p> |
7110 |
|
</blockquote> |
7111 |
|
|
7112 |
|
|
7113 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
7114 |
|
</p> |
7115 |
|
<blockquote class="text"> |
7116 |
|
<p>if the voice limit was set, but there are noteworthy |
7117 |
|
issue(s) related, providing an appropriate warning code and |
7118 |
|
warning message |
7119 |
|
</p> |
7120 |
|
</blockquote> |
7121 |
|
|
7122 |
|
|
7123 |
|
<p>"ERR:<error-code>:<error-message>" - |
7124 |
|
</p> |
7125 |
|
<blockquote class="text"> |
7126 |
|
<p>in case it failed, providing an appropriate error code and error message |
7127 |
|
</p> |
7128 |
|
</blockquote> |
7129 |
|
|
7130 |
|
|
7131 |
|
</blockquote><p> |
7132 |
|
|
7133 |
|
</p> |
7134 |
|
<p>Note: the given value will be passed to all sampler engine instances. |
7135 |
|
The total amount of maximum voices on the running system might thus |
7136 |
|
be as big as the given value multiplied by the current amount of engine |
7137 |
|
instances. |
7138 |
|
</p> |
7139 |
|
<p>Caution: when adjusting the voice limit, you SHOULD also |
7140 |
|
adjust the disk stream limit respectively and vice versa. |
7141 |
|
</p> |
7142 |
|
<a name="GET STREAMS"></a><br /><hr /> |
7143 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7144 |
|
<a name="rfc.section.6.6.10"></a><h3>6.6.10. |
7145 |
|
Getting global disk stream limit</h3> |
7146 |
|
|
7147 |
|
<p>The client can ask for the current global sampler-wide limit |
7148 |
|
for maximum disk streams by sending the following command: |
7149 |
|
</p> |
7150 |
|
<p> |
7151 |
|
</p> |
7152 |
|
<blockquote class="text"> |
7153 |
|
<p>GET STREAMS |
7154 |
|
</p> |
7155 |
|
</blockquote><p> |
7156 |
|
|
7157 |
|
</p> |
7158 |
|
<p>Possible Answers: |
7159 |
|
</p> |
7160 |
|
<p> |
7161 |
|
</p> |
7162 |
|
<blockquote class="text"> |
7163 |
|
<p>LinuxSampler will answer by returning the number for |
7164 |
|
the current limit of maximum disk streams. |
7165 |
|
</p> |
7166 |
|
</blockquote><p> |
7167 |
|
|
7168 |
|
</p> |
7169 |
|
<p>The disk stream limit setting defines how many disk streams should |
7170 |
|
maximum be processed by a sampler engine at the same time. The |
7171 |
|
higher this value, the more memory (RAM) will be occupied, since |
7172 |
|
every disk streams allocates a certain buffer size for being able |
7173 |
|
to perform its streaming operations. |
7174 |
|
</p> |
7175 |
|
<a name="SET STREAMS"></a><br /><hr /> |
7176 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7177 |
|
<a name="rfc.section.6.6.11"></a><h3>6.6.11. |
7178 |
|
Setting global disk stream limit</h3> |
7179 |
|
|
7180 |
|
<p>The client can alter the current global sampler-wide limit |
7181 |
|
for maximum disk streams by sending the following command: |
7182 |
|
</p> |
7183 |
|
<p> |
7184 |
|
</p> |
7185 |
|
<blockquote class="text"> |
7186 |
|
<p>SET STREAMS <max-streams> |
7187 |
|
</p> |
7188 |
|
</blockquote><p> |
7189 |
|
|
7190 |
|
</p> |
7191 |
|
<p>Where <max-streams> should be replaced by the integer |
7192 |
|
value, reflecting the new global amount limit of maximum disk streams. |
7193 |
|
This value has to be positive. |
7194 |
|
</p> |
7195 |
|
<p>Possible Answers: |
7196 |
|
</p> |
7197 |
|
<p> |
7198 |
|
</p> |
7199 |
|
<blockquote class="text"> |
7200 |
|
<p>"OK" - |
7201 |
|
</p> |
7202 |
|
<blockquote class="text"> |
7203 |
|
<p>on success |
7204 |
|
</p> |
7205 |
|
</blockquote> |
7206 |
|
|
7207 |
|
|
7208 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
7209 |
|
</p> |
7210 |
|
<blockquote class="text"> |
7211 |
|
<p>if the disk stream limit was set, but there are noteworthy |
7212 |
|
issue(s) related, providing an appropriate warning code and |
7213 |
|
warning message |
7214 |
|
</p> |
7215 |
|
</blockquote> |
7216 |
|
|
7217 |
|
|
7218 |
|
<p>"ERR:<error-code>:<error-message>" - |
7219 |
|
</p> |
7220 |
|
<blockquote class="text"> |
7221 |
|
<p>in case it failed, providing an appropriate error code and error message |
7222 |
|
</p> |
7223 |
|
</blockquote> |
7224 |
|
|
7225 |
|
|
7226 |
|
</blockquote><p> |
7227 |
|
|
7228 |
|
</p> |
7229 |
|
<p>Note: the given value will be passed to all sampler engine instances. |
7230 |
|
The total amount of maximum disk streams on the running system might |
7231 |
|
thus be as big as the given value multiplied by the current amount of |
7232 |
|
engine instances. |
7233 |
|
</p> |
7234 |
|
<p>Caution: when adjusting the disk stream limit, you SHOULD also |
7235 |
|
adjust the voice limit respectively and vice versa. |
7236 |
|
</p> |
7237 |
<a name="MIDI Instrument Mapping"></a><br /><hr /> |
<a name="MIDI Instrument Mapping"></a><br /><hr /> |
7238 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7239 |
<a name="rfc.section.6.7"></a><h3>6.7. |
<a name="rfc.section.6.7"></a><h3>6.7. |
7268 |
cause the sampler to switch to the respective instrument as |
cause the sampler to switch to the respective instrument as |
7269 |
reflected by the current MIDI instrument map. |
reflected by the current MIDI instrument map. |
7270 |
</p> |
</p> |
7271 |
<a name="ADD MIDI_INSTRUMENT MAP"></a><br /><hr /> |
<a name="ADD MIDI_INSTRUMENT_MAP"></a><br /><hr /> |
7272 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7273 |
<a name="rfc.section.6.7.1"></a><h3>6.7.1. |
<a name="rfc.section.6.7.1"></a><h3>6.7.1. |
7274 |
Create a new MIDI instrument map</h3> |
Create a new MIDI instrument map</h3> |
7286 |
</p> |
</p> |
7287 |
<p>Where <name> is an optional argument allowing to |
<p>Where <name> is an optional argument allowing to |
7288 |
assign a custom name to the new map. MIDI instrument Map |
assign a custom name to the new map. MIDI instrument Map |
7289 |
names do not have to be unique. |
names do not have to be unique, but MUST be encapsulated |
7290 |
|
into apostrophes and support escape sequences as described |
7291 |
|
in chapter "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>". |
7292 |
|
|
7293 |
</p> |
</p> |
7294 |
<p>Possible Answers: |
<p>Possible Answers: |
7295 |
</p> |
</p> |
7547 |
<blockquote class="text"> |
<blockquote class="text"> |
7548 |
<p>custom name of the given map, |
<p>custom name of the given map, |
7549 |
which does not have to be unique |
which does not have to be unique |
7550 |
|
(note that this character string may contain |
7551 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
7552 |
|
</p> |
7553 |
|
</blockquote> |
7554 |
|
|
7555 |
|
|
7556 |
|
<p>DEFAULT - |
7557 |
|
</p> |
7558 |
|
<blockquote class="text"> |
7559 |
|
<p>either true or false, |
7560 |
|
defines whether this map is the default map |
7561 |
</p> |
</p> |
7562 |
</blockquote> |
</blockquote> |
7563 |
|
|
7579 |
</p> |
</p> |
7580 |
<p>S: "NAME: Standard Map" |
<p>S: "NAME: Standard Map" |
7581 |
</p> |
</p> |
7582 |
|
<p> "DEFAULT: true" |
7583 |
|
</p> |
7584 |
<p> "." |
<p> "." |
7585 |
</p> |
</p> |
7586 |
</blockquote><p> |
</blockquote><p> |
7604 |
</p> |
</p> |
7605 |
<p>Where <map> is the numerical ID of the map and |
<p>Where <map> is the numerical ID of the map and |
7606 |
<name> the new custom name of the map, which does not |
<name> the new custom name of the map, which does not |
7607 |
have to be unique. |
have to be unique (name MUST be encapsulated into apostrophes |
7608 |
|
and supports escape sequences as described in chapter |
7609 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
7610 |
|
|
7611 |
</p> |
</p> |
7612 |
<p>Possible Answers: |
<p>Possible Answers: |
7613 |
</p> |
</p> |
7657 |
<p> |
<p> |
7658 |
</p> |
</p> |
7659 |
<blockquote class="text"> |
<blockquote class="text"> |
7660 |
<p>MAP MIDI_INSTRUMENT <map> |
<p>MAP MIDI_INSTRUMENT [NON_MODAL] <map> |
7661 |
<midi_bank> <midi_prog> <engine_name> |
<midi_bank> <midi_prog> <engine_name> |
7662 |
<filename> <instrument_index> <volume_value> |
<filename> <instrument_index> <volume_value> |
7663 |
[<instr_load_mode>] [<name>] |
[<instr_load_mode>] [<name>] |
7673 |
index, <engine_name> a sampler engine name as returned by |
index, <engine_name> a sampler engine name as returned by |
7674 |
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> |
7675 |
command (not encapsulated into apostrophes), <filename> the name |
command (not encapsulated into apostrophes), <filename> the name |
7676 |
of the instrument's file to be deployed (encapsulated into apostrophes), |
of the instrument's file to be deployed (encapsulated into apostrophes, |
7677 |
|
supporting escape sequences as described in chapter |
7678 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"), |
7679 |
<instrument_index> the index (integer value) of the instrument |
<instrument_index> the index (integer value) of the instrument |
7680 |
within the given file, <volume_value> reflects the master |
within the given file, <volume_value> reflects the master |
7681 |
volume of the instrument as optionally dotted number (where a |
volume of the instrument as optionally dotted number (where a |
7682 |
value < 1.0 means attenuation and a value > 1.0 means |
value < 1.0 means attenuation and a value > 1.0 means |
7683 |
amplification). This parameter easily allows to adjust the |
amplification). This parameter easily allows to adjust the |
7684 |
volume of all intruments within a custom instrument map |
volume of all intruments within a custom instrument map |
7685 |
without having to adjust their instrument files. The |
without having to adjust their instrument files. The |
7723 |
</p> |
</p> |
7724 |
<blockquote class="text"> |
<blockquote class="text"> |
7725 |
<p>The instrument will immediately be loaded |
<p>The instrument will immediately be loaded |
7726 |
into memory in the background when this mapping |
into memory when this mapping |
7727 |
command is sent and the instrument is kept all |
command is sent and the instrument is kept all |
7728 |
the time. Instruments with this mode are |
the time. Instruments with this mode are |
7729 |
only freed when the sampler is reset or all |
only freed when the sampler is reset or all |
7772 |
load modes of entries, the frontend should retrieve the actual |
load modes of entries, the frontend should retrieve the actual |
7773 |
mode by i.e. sending |
mode by i.e. sending |
7774 |
<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> |
7775 |
command(s). Finally the OPTIONAL <name> argument allows to |
command(s). Finally the OPTIONAL <name> argument allows to set a custom name |
7776 |
set a custom name (encapsulated into apostrophes) for the mapping |
(encapsulated into apostrophes, supporting escape sequences as described in chapter |
7777 |
entry, useful for frontends for displaying an appropriate name for |
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>") for the |
7778 |
|
mapping entry, useful for frontends for displaying an appropriate name for |
7779 |
mapped instruments (using |
mapped instruments (using |
7780 |
<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>). |
7781 |
|
|
7782 |
</p> |
</p> |
7783 |
<p> |
<p> |
7784 |
The "MAP MIDI_INSTRUMENT" command |
By default, "MAP MIDI_INSTRUMENT" commands block until the mapping is |
7785 |
will immediately return, thus it will not block when an |
completely established in the sampler. The OPTIONAL "NON_MODAL" argument |
7786 |
instrument is to be loaded due to a "PERSISTENT" type |
however causes the respective "MAP MIDI_INSTRUMENT" command to return |
7787 |
entry as instruments are loaded in the background. As a |
immediately, that is to let the sampler establish the mapping in the |
7788 |
consequence this command may not necessarily return an error |
background. So this argument might be especially useful for mappings with |
7789 |
i.e. when the given instrument file does not exist or may |
a "PERSISTENT" type, because these have to load the respective instruments |
7790 |
turn out to be corrupt. |
immediately and might thus block for a very long time. It is recommended |
7791 |
|
however to use the OPTIONAL "NON_MODAL" argument only if really necessary, |
7792 |
|
because it has the following drawbacks: as "NON_MODAL" instructions return |
7793 |
|
immediately, they may not necessarily return an error i.e. when the given |
7794 |
|
instrument file turns out to be corrupt, beside that subsequent commands |
7795 |
|
in a LSCP instruction sequence might fail, because mandatory mappings are |
7796 |
|
not yet completed. |
7797 |
|
|
7798 |
</p> |
</p> |
7799 |
<p>Possible Answers: |
<p>Possible Answers: |
7860 |
<p> |
<p> |
7861 |
</p> |
</p> |
7862 |
<blockquote class="text"> |
<blockquote class="text"> |
7863 |
<p>C: "MAP MIDI_INSTRUMENT 1 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'" |
<p>C: "MAP MIDI_INSTRUMENT NON_MODAL 1 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'" |
7864 |
</p> |
</p> |
7865 |
<p>S: "OK" |
<p>S: "OK" |
7866 |
</p> |
</p> |
7870 |
<a name="GET MIDI_INSTRUMENTS"></a><br /><hr /> |
<a name="GET MIDI_INSTRUMENTS"></a><br /><hr /> |
7871 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7872 |
<a name="rfc.section.6.7.8"></a><h3>6.7.8. |
<a name="rfc.section.6.7.8"></a><h3>6.7.8. |
7873 |
Getting ammount of MIDI instrument map entries</h3> |
Getting amount of MIDI instrument map entries</h3> |
7874 |
|
|
7875 |
<p>The front-end can query the amount of currently existing |
<p>The front-end can query the amount of currently existing |
7876 |
entries in a MIDI instrument map by sending the following |
entries in a MIDI instrument map by sending the following |
8097 |
changed with the |
changed with the |
8098 |
<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> |
8099 |
command and does not have to be unique. |
command and does not have to be unique. |
8100 |
|
(note that this character string may contain |
8101 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
8102 |
</p> |
</p> |
8103 |
</blockquote> |
</blockquote> |
8104 |
|
|
8115 |
<p>"INSTRUMENT_FILE" - |
<p>"INSTRUMENT_FILE" - |
8116 |
</p> |
</p> |
8117 |
<blockquote class="text"> |
<blockquote class="text"> |
8118 |
<p>File name of the instrument. |
<p>File name of the instrument |
8119 |
|
(note that this path may contain |
8120 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>). |
8121 |
</p> |
</p> |
8122 |
</blockquote> |
</blockquote> |
8123 |
|
|
8135 |
<blockquote class="text"> |
<blockquote class="text"> |
8136 |
<p>Name of the loaded instrument as reflected by its file. |
<p>Name of the loaded instrument as reflected by its file. |
8137 |
In contrast to the "NAME" field, the "INSTRUMENT_NAME" field |
In contrast to the "NAME" field, the "INSTRUMENT_NAME" field |
8138 |
cannot be changed. |
cannot be changed (note that this character string may contain |
8139 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>). |
8140 |
</p> |
</p> |
8141 |
</blockquote> |
</blockquote> |
8142 |
|
|
8154 |
</p> |
</p> |
8155 |
<blockquote class="text"> |
<blockquote class="text"> |
8156 |
<p>master volume of the instrument as optionally |
<p>master volume of the instrument as optionally |
8157 |
dotted number (where a value < 1.0 means attenuation |
dotted number (where a value < 1.0 means attenuation |
8158 |
and a value > 1.0 means amplification) |
and a value > 1.0 means amplification) |
8159 |
</p> |
</p> |
8160 |
</blockquote> |
</blockquote> |
8263 |
</blockquote><p> |
</blockquote><p> |
8264 |
|
|
8265 |
</p> |
</p> |
8266 |
|
<a name="Managing Instruments Database"></a><br /><hr /> |
8267 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8268 |
|
<a name="rfc.section.6.8"></a><h3>6.8. |
8269 |
|
Managing Instruments Database</h3> |
8270 |
|
|
8271 |
|
<p>The following commands describe how to use and manage |
8272 |
|
the instruments database. |
8273 |
|
</p> |
8274 |
|
<p>Notice: |
8275 |
|
</p> |
8276 |
|
<p> |
8277 |
|
</p> |
8278 |
|
<blockquote class="text"> |
8279 |
|
<p>All command arguments representing a path or |
8280 |
|
instrument/directory name support escape sequences as described in chapter |
8281 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>". |
8282 |
|
|
8283 |
|
</p> |
8284 |
|
<p>All occurrences of a forward slash in instrument and directory |
8285 |
|
names are escaped with its hex (\x2f) or octal (\057) escape sequence. |
8286 |
|
|
8287 |
|
</p> |
8288 |
|
</blockquote><p> |
8289 |
|
|
8290 |
|
</p> |
8291 |
|
<a name="ADD DB_INSTRUMENT_DIRECTORY"></a><br /><hr /> |
8292 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8293 |
|
<a name="rfc.section.6.8.1"></a><h3>6.8.1. |
8294 |
|
Creating a new instrument directory</h3> |
8295 |
|
|
8296 |
|
<p>The front-end can add a new instrument directory to the |
8297 |
|
instruments database by sending the following command: |
8298 |
|
</p> |
8299 |
|
<p> |
8300 |
|
</p> |
8301 |
|
<blockquote class="text"> |
8302 |
|
<p>ADD DB_INSTRUMENT_DIRECTORY <dir> |
8303 |
|
</p> |
8304 |
|
</blockquote><p> |
8305 |
|
|
8306 |
|
</p> |
8307 |
|
<p>Where <dir> is the absolute path name of the directory |
8308 |
|
to be created (encapsulated into apostrophes). |
8309 |
|
</p> |
8310 |
|
<p>Possible Answers: |
8311 |
|
</p> |
8312 |
|
<p> |
8313 |
|
</p> |
8314 |
|
<blockquote class="text"> |
8315 |
|
<p>"OK" - |
8316 |
|
</p> |
8317 |
|
<blockquote class="text"> |
8318 |
|
<p>on success |
8319 |
|
</p> |
8320 |
|
</blockquote> |
8321 |
|
|
8322 |
|
|
8323 |
|
<p>"ERR:<error-code>:<error-message>" - |
8324 |
|
</p> |
8325 |
|
<blockquote class="text"> |
8326 |
|
<p>when the directory could not be created, which |
8327 |
|
can happen if the directory already exists or the |
8328 |
|
name contains not allowed symbols |
8329 |
|
</p> |
8330 |
|
</blockquote> |
8331 |
|
|
8332 |
|
|
8333 |
|
</blockquote><p> |
8334 |
|
|
8335 |
|
</p> |
8336 |
|
<p>Examples: |
8337 |
|
</p> |
8338 |
|
<p> |
8339 |
|
</p> |
8340 |
|
<blockquote class="text"> |
8341 |
|
<p>C: "ADD DB_INSTRUMENT_DIRECTORY '/Piano Collection'" |
8342 |
|
</p> |
8343 |
|
<p>S: "OK" |
8344 |
|
</p> |
8345 |
|
</blockquote><p> |
8346 |
|
|
8347 |
|
</p> |
8348 |
|
<a name="REMOVE DB_INSTRUMENT_DIRECTORY"></a><br /><hr /> |
8349 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8350 |
|
<a name="rfc.section.6.8.2"></a><h3>6.8.2. |
8351 |
|
Deleting an instrument directory</h3> |
8352 |
|
|
8353 |
|
<p>The front-end can delete a particular instrument directory |
8354 |
|
from the instruments database by sending the following command: |
8355 |
|
</p> |
8356 |
|
<p> |
8357 |
|
</p> |
8358 |
|
<blockquote class="text"> |
8359 |
|
<p>REMOVE DB_INSTRUMENT_DIRECTORY [FORCE] <dir> |
8360 |
|
</p> |
8361 |
|
</blockquote><p> |
8362 |
|
|
8363 |
|
</p> |
8364 |
|
<p>Where <dir> is the absolute path name of the directory |
8365 |
|
to delete. The optional FORCE argument can be used to |
8366 |
|
force the deletion of a non-empty directory and all its content. |
8367 |
|
</p> |
8368 |
|
<p>Possible Answers: |
8369 |
|
</p> |
8370 |
|
<p> |
8371 |
|
</p> |
8372 |
|
<blockquote class="text"> |
8373 |
|
<p>"OK" - |
8374 |
|
</p> |
8375 |
|
<blockquote class="text"> |
8376 |
|
<p>if the directory is deleted successfully |
8377 |
|
</p> |
8378 |
|
</blockquote> |
8379 |
|
|
8380 |
|
|
8381 |
|
<p>"ERR:<error-code>:<error-message>" - |
8382 |
|
</p> |
8383 |
|
<blockquote class="text"> |
8384 |
|
<p>if the given directory does not exist, or |
8385 |
|
if trying to delete a non-empty directory, |
8386 |
|
without using the FORCE argument. |
8387 |
|
</p> |
8388 |
|
</blockquote> |
8389 |
|
|
8390 |
|
|
8391 |
|
</blockquote><p> |
8392 |
|
|
8393 |
|
</p> |
8394 |
|
<p>Examples: |
8395 |
|
</p> |
8396 |
|
<p> |
8397 |
|
</p> |
8398 |
|
<blockquote class="text"> |
8399 |
|
<p>C: "REMOVE DB_INSTRUMENT_DIRECTORY FORCE '/Piano Collection'" |
8400 |
|
</p> |
8401 |
|
<p>S: "OK" |
8402 |
|
</p> |
8403 |
|
</blockquote><p> |
8404 |
|
|
8405 |
|
</p> |
8406 |
|
<a name="GET DB_INSTRUMENT_DIRECTORIES"></a><br /><hr /> |
8407 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8408 |
|
<a name="rfc.section.6.8.3"></a><h3>6.8.3. |
8409 |
|
Getting amount of instrument directories</h3> |
8410 |
|
|
8411 |
|
<p>The front-end can retrieve the current amount of |
8412 |
|
directories in a specific directory by sending the following command: |
8413 |
|
</p> |
8414 |
|
<p> |
8415 |
|
</p> |
8416 |
|
<blockquote class="text"> |
8417 |
|
<p>GET DB_INSTRUMENT_DIRECTORIES [RECURSIVE] <dir> |
8418 |
|
</p> |
8419 |
|
</blockquote><p> |
8420 |
|
|
8421 |
|
</p> |
8422 |
|
<p>Where <dir> should be replaced by the absolute path |
8423 |
|
name of the directory. If RECURSIVE is specified, the number of |
8424 |
|
all directories, including those located in subdirectories of the |
8425 |
|
specified directory, will be returned. |
8426 |
|
</p> |
8427 |
|
<p>Possible Answers: |
8428 |
|
</p> |
8429 |
|
<p> |
8430 |
|
</p> |
8431 |
|
<blockquote class="text"> |
8432 |
|
<p>The current number of instrument directories |
8433 |
|
in the specified directory. |
8434 |
|
</p> |
8435 |
|
<p>"ERR:<error-code>:<error-message>" - |
8436 |
|
</p> |
8437 |
|
<blockquote class="text"> |
8438 |
|
<p>if the given directory does not exist. |
8439 |
|
</p> |
8440 |
|
</blockquote> |
8441 |
|
|
8442 |
|
|
8443 |
|
</blockquote><p> |
8444 |
|
|
8445 |
|
</p> |
8446 |
|
<p>Example: |
8447 |
|
</p> |
8448 |
|
<p> |
8449 |
|
</p> |
8450 |
|
<blockquote class="text"> |
8451 |
|
<p>C: "GET DB_INSTRUMENT_DIRECTORIES '/'" |
8452 |
|
</p> |
8453 |
|
<p>S: "2" |
8454 |
|
</p> |
8455 |
|
</blockquote><p> |
8456 |
|
|
8457 |
|
</p> |
8458 |
|
<a name="LIST DB_INSTRUMENT_DIRECTORIES"></a><br /><hr /> |
8459 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8460 |
|
<a name="rfc.section.6.8.4"></a><h3>6.8.4. |
8461 |
|
Listing all directories in specific directory</h3> |
8462 |
|
|
8463 |
|
<p>The front-end can retrieve the current list of directories |
8464 |
|
in specific directory by sending the following command: |
8465 |
|
</p> |
8466 |
|
<p> |
8467 |
|
</p> |
8468 |
|
<blockquote class="text"> |
8469 |
|
<p>LIST DB_INSTRUMENT_DIRECTORIES [RECURSIVE] <dir> |
8470 |
|
</p> |
8471 |
|
</blockquote><p> |
8472 |
|
|
8473 |
|
</p> |
8474 |
|
<p>Where <dir> should be replaced by the absolute path |
8475 |
|
name of the directory. If RECURSIVE is specified, the absolute path names |
8476 |
|
of all directories, including those located in subdirectories of the |
8477 |
|
specified directory, will be returned. |
8478 |
|
</p> |
8479 |
|
<p>Possible Answers: |
8480 |
|
</p> |
8481 |
|
<p> |
8482 |
|
</p> |
8483 |
|
<blockquote class="text"> |
8484 |
|
<p>A comma separated list of all instrument directories |
8485 |
|
(encapsulated into apostrophes) in the specified directory. |
8486 |
|
</p> |
8487 |
|
<p>"ERR:<error-code>:<error-message>" - |
8488 |
|
</p> |
8489 |
|
<blockquote class="text"> |
8490 |
|
<p>if the given directory does not exist. |
8491 |
|
</p> |
8492 |
|
</blockquote> |
8493 |
|
|
8494 |
|
|
8495 |
|
</blockquote><p> |
8496 |
|
|
8497 |
|
</p> |
8498 |
|
<p>Example: |
8499 |
|
</p> |
8500 |
|
<p> |
8501 |
|
</p> |
8502 |
|
<blockquote class="text"> |
8503 |
|
<p>C: "LIST DB_INSTRUMENT_DIRECTORIES '/'" |
8504 |
|
</p> |
8505 |
|
<p>S: "'Piano Collection','Percussion Collection'" |
8506 |
|
</p> |
8507 |
|
</blockquote><p> |
8508 |
|
|
8509 |
|
</p> |
8510 |
|
<p> |
8511 |
|
</p> |
8512 |
|
<blockquote class="text"> |
8513 |
|
<p>C: "LIST DB_INSTRUMENT_DIRECTORIES RECURSIVE '/'" |
8514 |
|
</p> |
8515 |
|
<p>S: "'/Piano Collection','/Piano Collection/Acoustic','/Piano Collection/Acoustic/New','/Percussion Collection'" |
8516 |
|
</p> |
8517 |
|
</blockquote><p> |
8518 |
|
|
8519 |
|
</p> |
8520 |
|
<a name="GET DB_INSTRUMENT_DIRECTORY INFO"></a><br /><hr /> |
8521 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8522 |
|
<a name="rfc.section.6.8.5"></a><h3>6.8.5. |
8523 |
|
Getting instrument directory information</h3> |
8524 |
|
|
8525 |
|
<p>The front-end can ask for the current settings of an |
8526 |
|
instrument directory by sending the following command: |
8527 |
|
</p> |
8528 |
|
<p> |
8529 |
|
</p> |
8530 |
|
<blockquote class="text"> |
8531 |
|
<p>GET DB_INSTRUMENT_DIRECTORY INFO <dir> |
8532 |
|
</p> |
8533 |
|
</blockquote><p> |
8534 |
|
|
8535 |
|
</p> |
8536 |
|
<p>Where <dir> should be replaced by the absolute path |
8537 |
|
name of the directory the front-end is interested in. |
8538 |
|
</p> |
8539 |
|
<p>Possible Answers: |
8540 |
|
</p> |
8541 |
|
<p> |
8542 |
|
</p> |
8543 |
|
<blockquote class="text"> |
8544 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
8545 |
|
Each answer line begins with the settings category name |
8546 |
|
followed by a colon and then a space character <SP> and finally |
8547 |
|
the info character string to that setting category. At the |
8548 |
|
moment the following categories are defined: |
8549 |
|
</p> |
8550 |
|
<p> |
8551 |
|
</p> |
8552 |
|
<blockquote class="text"> |
8553 |
|
<p>DESCRIPTION - |
8554 |
|
</p> |
8555 |
|
<blockquote class="text"> |
8556 |
|
<p>A brief description of the directory content. |
8557 |
|
Note that the character string may contain |
8558 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>. |
8559 |
|
</p> |
8560 |
|
</blockquote> |
8561 |
|
|
8562 |
|
|
8563 |
|
<p>CREATED - |
8564 |
|
</p> |
8565 |
|
<blockquote class="text"> |
8566 |
|
<p>The creation date and time of the directory, |
8567 |
|
represented in "YYYY-MM-DD HH:MM:SS" format |
8568 |
|
</p> |
8569 |
|
</blockquote> |
8570 |
|
|
8571 |
|
|
8572 |
|
<p>MODIFIED - |
8573 |
|
</p> |
8574 |
|
<blockquote class="text"> |
8575 |
|
<p>The date and time of the last modification of the |
8576 |
|
directory, represented in "YYYY-MM-DD HH:MM:SS" format |
8577 |
|
</p> |
8578 |
|
</blockquote> |
8579 |
|
|
8580 |
|
|
8581 |
|
</blockquote> |
8582 |
|
|
8583 |
|
|
8584 |
|
</blockquote><p> |
8585 |
|
|
8586 |
|
</p> |
8587 |
|
<p>The mentioned fields above don't have to be in particular order. |
8588 |
|
</p> |
8589 |
|
<p>Example: |
8590 |
|
</p> |
8591 |
|
<p> |
8592 |
|
</p> |
8593 |
|
<blockquote class="text"> |
8594 |
|
<p>C: "GET DB_INSTRUMENT_DIRECTORY INFO '/Piano Collection'" |
8595 |
|
</p> |
8596 |
|
<p>S: "DESCRIPTION: Piano collection of instruments in GigaSampler format." |
8597 |
|
</p> |
8598 |
|
<p> "CREATED: 2007-02-05 10:23:12" |
8599 |
|
</p> |
8600 |
|
<p> "MODIFIED: 2007-04-07 12:50:21" |
8601 |
|
</p> |
8602 |
|
<p> "." |
8603 |
|
</p> |
8604 |
|
</blockquote><p> |
8605 |
|
|
8606 |
|
</p> |
8607 |
|
<a name="SET DB_INSTRUMENT_DIRECTORY NAME"></a><br /><hr /> |
8608 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8609 |
|
<a name="rfc.section.6.8.6"></a><h3>6.8.6. |
8610 |
|
Renaming an instrument directory</h3> |
8611 |
|
|
8612 |
|
<p>The front-end can alter the name of a specific |
8613 |
|
instrument directory by sending the following command: |
8614 |
|
</p> |
8615 |
|
<p> |
8616 |
|
</p> |
8617 |
|
<blockquote class="text"> |
8618 |
|
<p>SET DB_INSTRUMENT_DIRECTORY NAME <dir> <name> |
8619 |
|
</p> |
8620 |
|
</blockquote><p> |
8621 |
|
|
8622 |
|
</p> |
8623 |
|
<p>Where <dir> is the absolute path name of the directory and |
8624 |
|
<name> is the new name for that directory. |
8625 |
|
</p> |
8626 |
|
<p>Possible Answers: |
8627 |
|
</p> |
8628 |
|
<p> |
8629 |
|
</p> |
8630 |
|
<blockquote class="text"> |
8631 |
|
<p>"OK" - |
8632 |
|
</p> |
8633 |
|
<blockquote class="text"> |
8634 |
|
<p>on success |
8635 |
|
</p> |
8636 |
|
</blockquote> |
8637 |
|
|
8638 |
|
|
8639 |
|
<p>"ERR:<error-code>:<error-message>" - |
8640 |
|
</p> |
8641 |
|
<blockquote class="text"> |
8642 |
|
<p>in case the given directory does not exists, |
8643 |
|
or if a directory with name equal to the new |
8644 |
|
name already exists. |
8645 |
|
</p> |
8646 |
|
</blockquote> |
8647 |
|
|
8648 |
|
|
8649 |
|
</blockquote><p> |
8650 |
|
|
8651 |
|
</p> |
8652 |
|
<p>Example: |
8653 |
|
</p> |
8654 |
|
<p> |
8655 |
|
</p> |
8656 |
|
<blockquote class="text"> |
8657 |
|
<p>C: "SET DB_INSTRUMENT_DIRECTORY NAME '/Piano Collection/Acustic' 'Acoustic'" |
8658 |
|
</p> |
8659 |
|
<p>S: "OK" |
8660 |
|
</p> |
8661 |
|
</blockquote><p> |
8662 |
|
|
8663 |
|
</p> |
8664 |
|
<a name="MOVE DB_INSTRUMENT_DIRECTORY"></a><br /><hr /> |
8665 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8666 |
|
<a name="rfc.section.6.8.7"></a><h3>6.8.7. |
8667 |
|
Moving an instrument directory</h3> |
8668 |
|
|
8669 |
|
<p>The front-end can move a specific |
8670 |
|
instrument directory by sending the following command: |
8671 |
|
</p> |
8672 |
|
<p> |
8673 |
|
</p> |
8674 |
|
<blockquote class="text"> |
8675 |
|
<p>MOVE DB_INSTRUMENT_DIRECTORY <dir> <dst> |
8676 |
|
</p> |
8677 |
|
</blockquote><p> |
8678 |
|
|
8679 |
|
</p> |
8680 |
|
<p>Where <dir> is the absolute path name of the directory |
8681 |
|
to move and <dst> is the location where the directory will |
8682 |
|
be moved to. |
8683 |
|
</p> |
8684 |
|
<p>Possible Answers: |
8685 |
|
</p> |
8686 |
|
<p> |
8687 |
|
</p> |
8688 |
|
<blockquote class="text"> |
8689 |
|
<p>"OK" - |
8690 |
|
</p> |
8691 |
|
<blockquote class="text"> |
8692 |
|
<p>on success |
8693 |
|
</p> |
8694 |
|
</blockquote> |
8695 |
|
|
8696 |
|
|
8697 |
|
<p>"ERR:<error-code>:<error-message>" - |
8698 |
|
</p> |
8699 |
|
<blockquote class="text"> |
8700 |
|
<p>in case a given directory does not exists, |
8701 |
|
or if a directory with name equal to the name |
8702 |
|
of the specified directory already exists in |
8703 |
|
the destination directory. Error is also thrown |
8704 |
|
when trying to move a directory to a subdirectory |
8705 |
|
of itself. |
8706 |
|
</p> |
8707 |
|
</blockquote> |
8708 |
|
|
8709 |
|
|
8710 |
|
</blockquote><p> |
8711 |
|
|
8712 |
|
</p> |
8713 |
|
<p>Example: |
8714 |
|
</p> |
8715 |
|
<p> |
8716 |
|
</p> |
8717 |
|
<blockquote class="text"> |
8718 |
|
<p>C: "MOVE DB_INSTRUMENT_DIRECTORY '/Acoustic' '/Piano Collection/Acoustic'" |
8719 |
|
</p> |
8720 |
|
<p>S: "OK" |
8721 |
|
</p> |
8722 |
|
</blockquote><p> |
8723 |
|
|
8724 |
|
</p> |
8725 |
|
<a name="COPY DB_INSTRUMENT_DIRECTORY"></a><br /><hr /> |
8726 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8727 |
|
<a name="rfc.section.6.8.8"></a><h3>6.8.8. |
8728 |
|
Copying instrument directories</h3> |
8729 |
|
|
8730 |
|
<p>The front-end can copy a specific |
8731 |
|
instrument directory by sending the following command: |
8732 |
|
</p> |
8733 |
|
<p> |
8734 |
|
</p> |
8735 |
|
<blockquote class="text"> |
8736 |
|
<p>COPY DB_INSTRUMENT_DIRECTORY <dir> <dst> |
8737 |
|
</p> |
8738 |
|
</blockquote><p> |
8739 |
|
|
8740 |
|
</p> |
8741 |
|
<p>Where <dir> is the absolute path name of the directory |
8742 |
|
to copy and <dst> is the location where the directory will |
8743 |
|
be copied to. |
8744 |
|
</p> |
8745 |
|
<p>Possible Answers: |
8746 |
|
</p> |
8747 |
|
<p> |
8748 |
|
</p> |
8749 |
|
<blockquote class="text"> |
8750 |
|
<p>"OK" - |
8751 |
|
</p> |
8752 |
|
<blockquote class="text"> |
8753 |
|
<p>on success |
8754 |
|
</p> |
8755 |
|
</blockquote> |
8756 |
|
|
8757 |
|
|
8758 |
|
<p>"ERR:<error-code>:<error-message>" - |
8759 |
|
</p> |
8760 |
|
<blockquote class="text"> |
8761 |
|
<p>in case a given directory does not exists, |
8762 |
|
or if a directory with name equal to the name |
8763 |
|
of the specified directory already exists in |
8764 |
|
the destination directory. Error is also thrown |
8765 |
|
when trying to copy a directory to a subdirectory |
8766 |
|
of itself. |
8767 |
|
</p> |
8768 |
|
</blockquote> |
8769 |
|
|
8770 |
|
|
8771 |
|
</blockquote><p> |
8772 |
|
|
8773 |
|
</p> |
8774 |
|
<p>Example: |
8775 |
|
</p> |
8776 |
|
<p> |
8777 |
|
</p> |
8778 |
|
<blockquote class="text"> |
8779 |
|
<p>C: "COPY DB_INSTRUMENT_DIRECTORY '/Piano Collection/Acoustic' '/Acoustic/Pianos'" |
8780 |
|
</p> |
8781 |
|
<p>S: "OK" |
8782 |
|
</p> |
8783 |
|
</blockquote><p> |
8784 |
|
|
8785 |
|
</p> |
8786 |
|
<a name="SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"></a><br /><hr /> |
8787 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8788 |
|
<a name="rfc.section.6.8.9"></a><h3>6.8.9. |
8789 |
|
Changing the description of directory</h3> |
8790 |
|
|
8791 |
|
<p>The front-end can alter the description of a specific |
8792 |
|
instrument directory by sending the following command: |
8793 |
|
</p> |
8794 |
|
<p> |
8795 |
|
</p> |
8796 |
|
<blockquote class="text"> |
8797 |
|
<p>SET DB_INSTRUMENT_DIRECTORY DESCRIPTION <dir> <desc> |
8798 |
|
</p> |
8799 |
|
</blockquote><p> |
8800 |
|
|
8801 |
|
</p> |
8802 |
|
<p>Where <dir> is the absolute path name of the directory and |
8803 |
|
<desc> is the new description for the directory |
8804 |
|
(encapsulated into apostrophes, supporting escape sequences as described in chapter |
8805 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
8806 |
|
</p> |
8807 |
|
<p>Possible Answers: |
8808 |
|
</p> |
8809 |
|
<p> |
8810 |
|
</p> |
8811 |
|
<blockquote class="text"> |
8812 |
|
<p>"OK" - |
8813 |
|
</p> |
8814 |
|
<blockquote class="text"> |
8815 |
|
<p>on success |
8816 |
|
</p> |
8817 |
|
</blockquote> |
8818 |
|
|
8819 |
|
|
8820 |
|
<p>"ERR:<error-code>:<error-message>" - |
8821 |
|
</p> |
8822 |
|
<blockquote class="text"> |
8823 |
|
<p>in case the given directory does not exists. |
8824 |
|
</p> |
8825 |
|
</blockquote> |
8826 |
|
|
8827 |
|
|
8828 |
|
</blockquote><p> |
8829 |
|
|
8830 |
|
</p> |
8831 |
|
<p>Example: |
8832 |
|
</p> |
8833 |
|
<p> |
8834 |
|
</p> |
8835 |
|
<blockquote class="text"> |
8836 |
|
<p>C: "SET DB_INSTRUMENT_DIRECTORY DESCRIPTION '/Piano Collection' 'A collection of piano instruments in various format.'" |
8837 |
|
</p> |
8838 |
|
<p>S: "OK" |
8839 |
|
</p> |
8840 |
|
</blockquote><p> |
8841 |
|
|
8842 |
|
</p> |
8843 |
|
<a name="FIND DB_INSTRUMENT_DIRECTORIES"></a><br /><hr /> |
8844 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8845 |
|
<a name="rfc.section.6.8.10"></a><h3>6.8.10. |
8846 |
|
Finding directories</h3> |
8847 |
|
|
8848 |
|
<p>The front-end can search for directories |
8849 |
|
in specific directory by sending the following command: |
8850 |
|
</p> |
8851 |
|
<p> |
8852 |
|
</p> |
8853 |
|
<blockquote class="text"> |
8854 |
|
<p>FIND DB_INSTRUMENT_DIRECTORIES [NON_RECURSIVE] <dir> <criteria-list> |
8855 |
|
</p> |
8856 |
|
</blockquote><p> |
8857 |
|
|
8858 |
|
</p> |
8859 |
|
<p>Where <dir> should be replaced by the absolute path |
8860 |
|
name of the directory to search in. If NON_RECURSIVE is specified, the |
8861 |
|
directories located in subdirectories of the specified directory will not |
8862 |
|
be searched. <criteria-list> is a list of search criterias |
8863 |
|
in form of "key1=val1 key2=val2 ...". The following criterias are |
8864 |
|
allowed: |
8865 |
|
</p> |
8866 |
|
<p> |
8867 |
|
|
8868 |
|
<p>NAME='<search-string>' |
8869 |
|
</p> |
8870 |
|
<blockquote class="text"> |
8871 |
|
<p>Restricts the search to directories, which names |
8872 |
|
satisfy the supplied search string (encapsulated into apostrophes, |
8873 |
|
supporting escape sequences as described in chapter |
8874 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
8875 |
|
</p> |
8876 |
|
</blockquote><p> |
8877 |
|
|
8878 |
|
</p> |
8879 |
|
|
8880 |
|
|
8881 |
|
<p>CREATED='[<date-after>]..[<date-before>]' |
8882 |
|
</p> |
8883 |
|
<blockquote class="text"> |
8884 |
|
<p>Restricts the search to directories, which creation |
8885 |
|
date satisfies the specified period, where <date-after> |
8886 |
|
and <date-before> are in "YYYY-MM-DD HH:MM:SS" format. |
8887 |
|
If <date-after> is omitted the search is restricted to |
8888 |
|
directories created before <date-before>. If |
8889 |
|
<date-before> is omitted, the search is restricted |
8890 |
|
to directories created after <date-after>. |
8891 |
|
</p> |
8892 |
|
</blockquote><p> |
8893 |
|
|
8894 |
|
</p> |
8895 |
|
|
8896 |
|
|
8897 |
|
<p>MODIFIED='[<date-after>]..[<date-before>]' |
8898 |
|
</p> |
8899 |
|
<blockquote class="text"> |
8900 |
|
<p>Restricts the search to directories, which |
8901 |
|
date of last modification satisfies the specified period, where |
8902 |
|
<date-after> and <date-before> are in "YYYY-MM-DD HH:MM:SS" |
8903 |
|
format. If <date-after> is omitted the search is restricted to |
8904 |
|
directories, which are last modified before <date-before>. If |
8905 |
|
<date-before> is omitted, the search is restricted to directories, |
8906 |
|
which are last modified after <date-after>. |
8907 |
|
</p> |
8908 |
|
</blockquote><p> |
8909 |
|
|
8910 |
|
</p> |
8911 |
|
|
8912 |
|
|
8913 |
|
<p>DESCRIPTION='<search-string>' |
8914 |
|
</p> |
8915 |
|
<blockquote class="text"> |
8916 |
|
<p>Restricts the search to directories with description |
8917 |
|
that satisfies the supplied search string |
8918 |
|
(encapsulated into apostrophes, supporting escape |
8919 |
|
sequences as described in chapter |
8920 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
8921 |
|
</p> |
8922 |
|
</blockquote><p> |
8923 |
|
|
8924 |
|
</p> |
8925 |
|
|
8926 |
|
|
8927 |
|
<p>Where <search-string> is either a regular expression, or a |
8928 |
|
word list separated with spaces for OR search and with '+' for AND search. |
8929 |
|
</p> |
8930 |
|
<p>Possible Answers: |
8931 |
|
</p> |
8932 |
|
<p> |
8933 |
|
</p> |
8934 |
|
<blockquote class="text"> |
8935 |
|
<p>A comma separated list with the absolute path names (encapsulated into |
8936 |
|
apostrophes) of all directories in the specified directory that satisfy |
8937 |
|
the supplied search criterias. |
8938 |
|
</p> |
8939 |
|
<p>"ERR:<error-code>:<error-message>" - |
8940 |
|
</p> |
8941 |
|
<blockquote class="text"> |
8942 |
|
<p>if the given directory does not exist. |
8943 |
|
</p> |
8944 |
|
</blockquote> |
8945 |
|
|
8946 |
|
|
8947 |
|
</blockquote><p> |
8948 |
|
|
8949 |
|
</p> |
8950 |
|
<p>Example: |
8951 |
|
</p> |
8952 |
|
<p> |
8953 |
|
</p> |
8954 |
|
<blockquote class="text"> |
8955 |
|
<p>C: "FIND DB_INSTRUMENT_DIRECTORIES '/' NAME='Piano'" |
8956 |
|
</p> |
8957 |
|
<p>S: "'/Piano Collection'" |
8958 |
|
</p> |
8959 |
|
</blockquote><p> |
8960 |
|
|
8961 |
|
</p> |
8962 |
|
<p> |
8963 |
|
</p> |
8964 |
|
<blockquote class="text"> |
8965 |
|
<p>C: "FIND DB_INSTRUMENT_DIRECTORIES '/' CREATED='..2007-04-01 09:30:13'" |
8966 |
|
</p> |
8967 |
|
<p>S: "'/Piano Collection','/Percussions'" |
8968 |
|
</p> |
8969 |
|
</blockquote><p> |
8970 |
|
|
8971 |
|
</p> |
8972 |
|
<a name="ADD DB_INSTRUMENTS"></a><br /><hr /> |
8973 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
8974 |
|
<a name="rfc.section.6.8.11"></a><h3>6.8.11. |
8975 |
|
Adding instruments to the instruments database</h3> |
8976 |
|
|
8977 |
|
<p>The front-end can add one or more instruments |
8978 |
|
to the instruments database by sending the following command: |
8979 |
|
</p> |
8980 |
|
<p> |
8981 |
|
</p> |
8982 |
|
<blockquote class="text"> |
8983 |
|
<p>ADD DB_INSTRUMENTS [NON_MODAL] [<mode>[ FILE_AS_DIR]] <db_dir> <file_path> [<instr_index>] |
8984 |
|
</p> |
8985 |
|
</blockquote><p> |
8986 |
|
|
8987 |
|
</p> |
8988 |
|
<p>Where <db_dir> is the absolute path name of a directory |
8989 |
|
(encapsulated into apostrophes) in the instruments database in which |
8990 |
|
only the new instruments (that are not already in the database) will |
8991 |
|
be added, <file_path> is the absolute path name of a file or |
8992 |
|
directory in the file system (encapsulated into apostrophes). In case |
8993 |
|
an instrument file is supplied, only the instruments in the specified |
8994 |
|
file will be added to the instruments database. If the optional |
8995 |
|
<instr_index> (the index of the instrument within the given file) |
8996 |
|
is supplied too, then only the specified instrument will be added. |
8997 |
|
In case a directory is supplied, the instruments in that directory |
8998 |
|
will be added. The OPTIONAL <mode> argument is only applied |
8999 |
|
when a directory is provided as <file_path> and specifies how the |
9000 |
|
scanning will be done and has exactly the following possibilities: |
9001 |
|
</p> |
9002 |
|
<p> |
9003 |
|
</p> |
9004 |
|
<blockquote class="text"> |
9005 |
|
<p>"RECURSIVE" - |
9006 |
|
</p> |
9007 |
|
<blockquote class="text"> |
9008 |
|
<p>All instruments will be processed, including those |
9009 |
|
in the subdirectories, and the respective subdirectory |
9010 |
|
tree structure will be recreated in the instruments |
9011 |
|
database |
9012 |
|
</p> |
9013 |
|
</blockquote> |
9014 |
|
|
9015 |
|
|
9016 |
|
<p>"NON_RECURSIVE" - |
9017 |
|
</p> |
9018 |
|
<blockquote class="text"> |
9019 |
|
<p>Only the instruments in the specified directory |
9020 |
|
will be added, the instruments in the subdirectories |
9021 |
|
will not be processed. |
9022 |
|
</p> |
9023 |
|
</blockquote> |
9024 |
|
|
9025 |
|
|
9026 |
|
<p>"FLAT" - |
9027 |
|
</p> |
9028 |
|
<blockquote class="text"> |
9029 |
|
<p>All instruments will be processed, including those |
9030 |
|
in the subdirectories, but the respective subdirectory |
9031 |
|
structure will not be recreated in the instruments |
9032 |
|
database. All instruments will be added directly in |
9033 |
|
the specified database directory. |
9034 |
|
</p> |
9035 |
|
</blockquote> |
9036 |
|
|
9037 |
|
|
9038 |
|
</blockquote><p> |
9039 |
|
|
9040 |
|
</p> |
9041 |
|
<p> If FILE_AS_DIR argument is supplied, all instruments in an instrument |
9042 |
|
file will be added to a separate directory in the instruments database, which |
9043 |
|
name will be the name of the instrument file with the file extension stripped off. |
9044 |
|
|
9045 |
|
</p> |
9046 |
|
<p>The difference between regular and NON_MODAL versions of the command |
9047 |
|
is that the regular command returns when the scanning is finished |
9048 |
|
while NON_MODAL version returns immediately and a background process is launched. |
9049 |
|
The <a class='info' href='#GET DB_INSTRUMENTS_JOB INFO'>GET DB_INSTRUMENTS_JOB INFO<span> (</span><span class='info'>Getting job status information</span><span>)</span></a> |
9050 |
|
command can be used to monitor the scanning progress. |
9051 |
|
</p> |
9052 |
|
<p>Possible Answers: |
9053 |
|
</p> |
9054 |
|
<p> |
9055 |
|
</p> |
9056 |
|
<blockquote class="text"> |
9057 |
|
<p>"OK" - |
9058 |
|
</p> |
9059 |
|
<blockquote class="text"> |
9060 |
|
<p>on success when NON_MODAL is not supplied |
9061 |
|
</p> |
9062 |
|
</blockquote> |
9063 |
|
|
9064 |
|
|
9065 |
|
<p>"OK[<job-id>]" - |
9066 |
|
</p> |
9067 |
|
<blockquote class="text"> |
9068 |
|
<p>on success when NON_MODAL is supplied, where <job-id> |
9069 |
|
is a numerical ID used to obtain status information about the job progress. |
9070 |
|
See <a class='info' href='#GET DB_INSTRUMENTS_JOB INFO'>GET DB_INSTRUMENTS_JOB INFO<span> (</span><span class='info'>Getting job status information</span><span>)</span></a> |
9071 |
|
|
9072 |
|
</p> |
9073 |
|
</blockquote> |
9074 |
|
|
9075 |
|
|
9076 |
|
<p>"ERR:<error-code>:<error-message>" - |
9077 |
|
</p> |
9078 |
|
<blockquote class="text"> |
9079 |
|
<p>if an invalid path is specified. |
9080 |
|
</p> |
9081 |
|
</blockquote> |
9082 |
|
|
9083 |
|
|
9084 |
|
</blockquote><p> |
9085 |
|
|
9086 |
|
</p> |
9087 |
|
<p>Examples: |
9088 |
|
</p> |
9089 |
|
<p> |
9090 |
|
</p> |
9091 |
|
<blockquote class="text"> |
9092 |
|
<p>C: "ADD DB_INSTRUMENTS '/Piano Collection' '/home/me/gigs/PMI Bosendorfer 290.gig' 0" |
9093 |
|
</p> |
9094 |
|
<p>S: "OK" |
9095 |
|
</p> |
9096 |
|
</blockquote><p> |
9097 |
|
|
9098 |
|
</p> |
9099 |
|
<a name="REMOVE DB_INSTRUMENT"></a><br /><hr /> |
9100 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9101 |
|
<a name="rfc.section.6.8.12"></a><h3>6.8.12. |
9102 |
|
Removing an instrument</h3> |
9103 |
|
|
9104 |
|
<p>The front-end can remove a particular instrument |
9105 |
|
from the instruments database by sending the following command: |
9106 |
|
</p> |
9107 |
|
<p> |
9108 |
|
</p> |
9109 |
|
<blockquote class="text"> |
9110 |
|
<p>REMOVE DB_INSTRUMENT <instr_path> |
9111 |
|
</p> |
9112 |
|
</blockquote><p> |
9113 |
|
|
9114 |
|
</p> |
9115 |
|
<p>Where <instr_path> is the absolute path name |
9116 |
|
(in the instruments database) of the instrument to remove. |
9117 |
|
</p> |
9118 |
|
<p>Possible Answers: |
9119 |
|
</p> |
9120 |
|
<p> |
9121 |
|
</p> |
9122 |
|
<blockquote class="text"> |
9123 |
|
<p>"OK" - |
9124 |
|
</p> |
9125 |
|
<blockquote class="text"> |
9126 |
|
<p>if the instrument is removed successfully |
9127 |
|
</p> |
9128 |
|
</blockquote> |
9129 |
|
|
9130 |
|
|
9131 |
|
<p>"ERR:<error-code>:<error-message>" - |
9132 |
|
</p> |
9133 |
|
<blockquote class="text"> |
9134 |
|
<p>if the given path does not exist or |
9135 |
|
is a directory. |
9136 |
|
</p> |
9137 |
|
</blockquote> |
9138 |
|
|
9139 |
|
|
9140 |
|
</blockquote><p> |
9141 |
|
|
9142 |
|
</p> |
9143 |
|
<p>Examples: |
9144 |
|
</p> |
9145 |
|
<p> |
9146 |
|
</p> |
9147 |
|
<blockquote class="text"> |
9148 |
|
<p>C: "REMOVE DB_INSTRUMENT '/Piano Collection/Bosendorfer 290'" |
9149 |
|
</p> |
9150 |
|
<p>S: "OK" |
9151 |
|
</p> |
9152 |
|
</blockquote><p> |
9153 |
|
|
9154 |
|
</p> |
9155 |
|
<a name="GET DB_INSTRUMENTS"></a><br /><hr /> |
9156 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9157 |
|
<a name="rfc.section.6.8.13"></a><h3>6.8.13. |
9158 |
|
Getting amount of instruments</h3> |
9159 |
|
|
9160 |
|
<p>The front-end can retrieve the current amount of |
9161 |
|
instruments in a specific directory by sending the following command: |
9162 |
|
</p> |
9163 |
|
<p> |
9164 |
|
</p> |
9165 |
|
<blockquote class="text"> |
9166 |
|
<p>GET DB_INSTRUMENTS [RECURSIVE] <dir> |
9167 |
|
</p> |
9168 |
|
</blockquote><p> |
9169 |
|
|
9170 |
|
</p> |
9171 |
|
<p>Where <dir> should be replaced by the absolute path name |
9172 |
|
of the directory. If RECURSIVE is specified, the number of all |
9173 |
|
instruments, including those located in subdirectories of the |
9174 |
|
specified directory, will be returned. |
9175 |
|
</p> |
9176 |
|
<p>Possible Answers: |
9177 |
|
</p> |
9178 |
|
<p> |
9179 |
|
</p> |
9180 |
|
<blockquote class="text"> |
9181 |
|
<p>The current number of instruments |
9182 |
|
in the specified directory. |
9183 |
|
</p> |
9184 |
|
<p>"ERR:<error-code>:<error-message>" - |
9185 |
|
</p> |
9186 |
|
<blockquote class="text"> |
9187 |
|
<p>if the given directory does not exist. |
9188 |
|
</p> |
9189 |
|
</blockquote> |
9190 |
|
|
9191 |
|
|
9192 |
|
</blockquote><p> |
9193 |
|
|
9194 |
|
</p> |
9195 |
|
<p>Example: |
9196 |
|
</p> |
9197 |
|
<p> |
9198 |
|
</p> |
9199 |
|
<blockquote class="text"> |
9200 |
|
<p>C: "GET DB_INSTRUMENTS '/Piano Collection'" |
9201 |
|
</p> |
9202 |
|
<p>S: "2" |
9203 |
|
</p> |
9204 |
|
</blockquote><p> |
9205 |
|
|
9206 |
|
</p> |
9207 |
|
<a name="LIST DB_INSTRUMENTS"></a><br /><hr /> |
9208 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9209 |
|
<a name="rfc.section.6.8.14"></a><h3>6.8.14. |
9210 |
|
Listing all instruments in specific directory</h3> |
9211 |
|
|
9212 |
|
<p>The front-end can retrieve the current list of instruments |
9213 |
|
in specific directory by sending the following command: |
9214 |
|
</p> |
9215 |
|
<p> |
9216 |
|
</p> |
9217 |
|
<blockquote class="text"> |
9218 |
|
<p>LIST DB_INSTRUMENTS [RECURSIVE] <dir> |
9219 |
|
</p> |
9220 |
|
</blockquote><p> |
9221 |
|
|
9222 |
|
</p> |
9223 |
|
<p>Where <dir> should be replaced by the absolute path |
9224 |
|
name of the directory. If RECURSIVE is specified, the absolute path |
9225 |
|
names of all instruments, including those located in subdirectories |
9226 |
|
of the specified directory, will be returned. |
9227 |
|
</p> |
9228 |
|
<p>Possible Answers: |
9229 |
|
</p> |
9230 |
|
<p> |
9231 |
|
</p> |
9232 |
|
<blockquote class="text"> |
9233 |
|
<p>A comma separated list of all instruments |
9234 |
|
(encapsulated into apostrophes) in the specified directory. |
9235 |
|
</p> |
9236 |
|
<p>"ERR:<error-code>:<error-message>" - |
9237 |
|
</p> |
9238 |
|
<blockquote class="text"> |
9239 |
|
<p>if the given directory does not exist. |
9240 |
|
</p> |
9241 |
|
</blockquote> |
9242 |
|
|
9243 |
|
|
9244 |
|
</blockquote><p> |
9245 |
|
|
9246 |
|
</p> |
9247 |
|
<p>Example: |
9248 |
|
</p> |
9249 |
|
<p> |
9250 |
|
</p> |
9251 |
|
<blockquote class="text"> |
9252 |
|
<p>C: "LIST DB_INSTRUMENTS '/Piano Collection'" |
9253 |
|
</p> |
9254 |
|
<p>S: "'Bosendorfer 290','Steinway D'" |
9255 |
|
</p> |
9256 |
|
</blockquote><p> |
9257 |
|
|
9258 |
|
</p> |
9259 |
|
<p> |
9260 |
|
</p> |
9261 |
|
<blockquote class="text"> |
9262 |
|
<p>C: "LIST DB_INSTRUMENTS RECURSIVE '/Piano Collection'" |
9263 |
|
</p> |
9264 |
|
<p>S: "'/Piano Collection/Bosendorfer 290','/Piano Collection/Steinway D','/Piano Collection/Lite/Free Piano'" |
9265 |
|
</p> |
9266 |
|
</blockquote><p> |
9267 |
|
|
9268 |
|
</p> |
9269 |
|
<a name="GET DB_INSTRUMENT INFO"></a><br /><hr /> |
9270 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9271 |
|
<a name="rfc.section.6.8.15"></a><h3>6.8.15. |
9272 |
|
Getting instrument information</h3> |
9273 |
|
|
9274 |
|
<p>The front-end can ask for the current settings of an |
9275 |
|
instrument by sending the following command: |
9276 |
|
</p> |
9277 |
|
<p> |
9278 |
|
</p> |
9279 |
|
<blockquote class="text"> |
9280 |
|
<p>GET DB_INSTRUMENT INFO <instr_path> |
9281 |
|
</p> |
9282 |
|
</blockquote><p> |
9283 |
|
|
9284 |
|
</p> |
9285 |
|
<p>Where <instr_path> should be replaced by the absolute path |
9286 |
|
name of the instrument the front-end is interested in. |
9287 |
|
</p> |
9288 |
|
<p>Possible Answers: |
9289 |
|
</p> |
9290 |
|
<p> |
9291 |
|
</p> |
9292 |
|
<blockquote class="text"> |
9293 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
9294 |
|
Each answer line begins with the settings category name |
9295 |
|
followed by a colon and then a space character <SP> and finally |
9296 |
|
the info character string to that setting category. At the |
9297 |
|
moment the following categories are defined: |
9298 |
|
</p> |
9299 |
|
<p> |
9300 |
|
</p> |
9301 |
|
<blockquote class="text"> |
9302 |
|
<p>INSTRUMENT_FILE - |
9303 |
|
</p> |
9304 |
|
<blockquote class="text"> |
9305 |
|
<p>File name of the instrument. |
9306 |
|
Note that the character string may contain |
9307 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>. |
9308 |
|
</p> |
9309 |
|
</blockquote> |
9310 |
|
|
9311 |
|
|
9312 |
|
<p>INSTRUMENT_NR - |
9313 |
|
</p> |
9314 |
|
<blockquote class="text"> |
9315 |
|
<p>Index of the instrument within the file. |
9316 |
|
</p> |
9317 |
|
</blockquote> |
9318 |
|
|
9319 |
|
|
9320 |
|
<p>FORMAT_FAMILY - |
9321 |
|
</p> |
9322 |
|
<blockquote class="text"> |
9323 |
|
<p>The format family of the instrument. |
9324 |
|
</p> |
9325 |
|
</blockquote> |
9326 |
|
|
9327 |
|
|
9328 |
|
<p>FORMAT_VERSION - |
9329 |
|
</p> |
9330 |
|
<blockquote class="text"> |
9331 |
|
<p>The format version of the instrument. |
9332 |
|
</p> |
9333 |
|
</blockquote> |
9334 |
|
|
9335 |
|
|
9336 |
|
<p>SIZE - |
9337 |
|
</p> |
9338 |
|
<blockquote class="text"> |
9339 |
|
<p>The size of the instrument in bytes. |
9340 |
|
</p> |
9341 |
|
</blockquote> |
9342 |
|
|
9343 |
|
|
9344 |
|
<p>CREATED - |
9345 |
|
</p> |
9346 |
|
<blockquote class="text"> |
9347 |
|
<p>The date and time when the instrument is added |
9348 |
|
in the instruments database, represented in |
9349 |
|
"YYYY-MM-DD HH:MM:SS" format |
9350 |
|
</p> |
9351 |
|
</blockquote> |
9352 |
|
|
9353 |
|
|
9354 |
|
<p>MODIFIED - |
9355 |
|
</p> |
9356 |
|
<blockquote class="text"> |
9357 |
|
<p>The date and time of the last modification of the |
9358 |
|
instrument's database settings, represented in |
9359 |
|
"YYYY-MM-DD HH:MM:SS" format |
9360 |
|
</p> |
9361 |
|
</blockquote> |
9362 |
|
|
9363 |
|
|
9364 |
|
<p>DESCRIPTION - |
9365 |
|
</p> |
9366 |
|
<blockquote class="text"> |
9367 |
|
<p>A brief description of the instrument. |
9368 |
|
Note that the character string may contain |
9369 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>. |
9370 |
|
</p> |
9371 |
|
</blockquote> |
9372 |
|
|
9373 |
|
|
9374 |
|
<p>IS_DRUM - |
9375 |
|
</p> |
9376 |
|
<blockquote class="text"> |
9377 |
|
<p>either true or false, determines whether the |
9378 |
|
instrument is a drumkit or a chromatic instrument |
9379 |
|
</p> |
9380 |
|
</blockquote> |
9381 |
|
|
9382 |
|
|
9383 |
|
<p>PRODUCT - |
9384 |
|
</p> |
9385 |
|
<blockquote class="text"> |
9386 |
|
<p>The product title of the instrument. |
9387 |
|
Note that the character string may contain |
9388 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>. |
9389 |
|
</p> |
9390 |
|
</blockquote> |
9391 |
|
|
9392 |
|
|
9393 |
|
<p>ARTISTS - |
9394 |
|
</p> |
9395 |
|
<blockquote class="text"> |
9396 |
|
<p>Lists the artist names. |
9397 |
|
Note that the character string may contain |
9398 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>. |
9399 |
|
</p> |
9400 |
|
</blockquote> |
9401 |
|
|
9402 |
|
|
9403 |
|
<p>KEYWORDS - |
9404 |
|
</p> |
9405 |
|
<blockquote class="text"> |
9406 |
|
<p>Provides a list of keywords that refer to the instrument. |
9407 |
|
Keywords are separated with semicolon and blank. |
9408 |
|
Note that the character string may contain |
9409 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>. |
9410 |
|
</p> |
9411 |
|
</blockquote> |
9412 |
|
|
9413 |
|
|
9414 |
|
</blockquote> |
9415 |
|
|
9416 |
|
|
9417 |
|
</blockquote><p> |
9418 |
|
|
9419 |
|
</p> |
9420 |
|
<p>The mentioned fields above don't have to be in particular order. |
9421 |
|
</p> |
9422 |
|
<p>Example: |
9423 |
|
</p> |
9424 |
|
<p> |
9425 |
|
</p> |
9426 |
|
<blockquote class="text"> |
9427 |
|
<p>C: "GET DB_INSTRUMENT INFO '/Piano Collection/Bosendorfer 290'" |
9428 |
|
</p> |
9429 |
|
<p>S: "INSTRUMENT_FILE: /home/me/gigs/Bosendorfer 290.gig" |
9430 |
|
</p> |
9431 |
|
<p> "INSTRUMENT_NR: 0" |
9432 |
|
</p> |
9433 |
|
<p> "FORMAT_FAMILY: GIG" |
9434 |
|
</p> |
9435 |
|
<p> "FORMAT_VERSION: 2" |
9436 |
|
</p> |
9437 |
|
<p> "SIZE: 2050871870" |
9438 |
|
</p> |
9439 |
|
<p> "CREATED: 2007-02-05 10:23:12" |
9440 |
|
</p> |
9441 |
|
<p> "MODIFIED: 2007-04-07 12:50:21" |
9442 |
|
</p> |
9443 |
|
<p> "DESCRIPTION: " |
9444 |
|
</p> |
9445 |
|
<p> "IS_DRUM: false" |
9446 |
|
</p> |
9447 |
|
<p> "PRODUCT: GRANDIOSO Bosendorfer 290" |
9448 |
|
</p> |
9449 |
|
<p> "ARTISTS: Post Musical Instruments" |
9450 |
|
</p> |
9451 |
|
<p> "KEYWORDS: Bosendorfer" |
9452 |
|
</p> |
9453 |
|
<p> "." |
9454 |
|
</p> |
9455 |
|
</blockquote><p> |
9456 |
|
|
9457 |
|
</p> |
9458 |
|
<a name="SET DB_INSTRUMENT NAME"></a><br /><hr /> |
9459 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9460 |
|
<a name="rfc.section.6.8.16"></a><h3>6.8.16. |
9461 |
|
Renaming an instrument</h3> |
9462 |
|
|
9463 |
|
<p>The front-end can alter the name of a specific |
9464 |
|
instrument by sending the following command: |
9465 |
|
</p> |
9466 |
|
<p> |
9467 |
|
</p> |
9468 |
|
<blockquote class="text"> |
9469 |
|
<p>SET DB_INSTRUMENT NAME <instr> <name> |
9470 |
|
</p> |
9471 |
|
</blockquote><p> |
9472 |
|
|
9473 |
|
</p> |
9474 |
|
<p>Where <instr> is the absolute path name of the instrument and |
9475 |
|
<name> is the new name for that instrument. |
9476 |
|
</p> |
9477 |
|
<p>Possible Answers: |
9478 |
|
</p> |
9479 |
|
<p> |
9480 |
|
</p> |
9481 |
|
<blockquote class="text"> |
9482 |
|
<p>"OK" - |
9483 |
|
</p> |
9484 |
|
<blockquote class="text"> |
9485 |
|
<p>on success |
9486 |
|
</p> |
9487 |
|
</blockquote> |
9488 |
|
|
9489 |
|
|
9490 |
|
<p>"ERR:<error-code>:<error-message>" - |
9491 |
|
</p> |
9492 |
|
<blockquote class="text"> |
9493 |
|
<p>in case the given instrument does not exists, |
9494 |
|
or if an instrument with name equal to the new |
9495 |
|
name already exists. |
9496 |
|
</p> |
9497 |
|
</blockquote> |
9498 |
|
|
9499 |
|
|
9500 |
|
</blockquote><p> |
9501 |
|
|
9502 |
|
</p> |
9503 |
|
<p>Example: |
9504 |
|
</p> |
9505 |
|
<p> |
9506 |
|
</p> |
9507 |
|
<blockquote class="text"> |
9508 |
|
<p>C: "SET DB_INSTRUMENT NAME '/Piano Collection/Bosendorfer' 'Bosendorfer 290'" |
9509 |
|
</p> |
9510 |
|
<p>S: "OK" |
9511 |
|
</p> |
9512 |
|
</blockquote><p> |
9513 |
|
|
9514 |
|
</p> |
9515 |
|
<a name="MOVE DB_INSTRUMENT"></a><br /><hr /> |
9516 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9517 |
|
<a name="rfc.section.6.8.17"></a><h3>6.8.17. |
9518 |
|
Moving an instrument</h3> |
9519 |
|
|
9520 |
|
<p>The front-end can move a specific instrument to another directory by |
9521 |
|
sending the following command: |
9522 |
|
</p> |
9523 |
|
<p> |
9524 |
|
</p> |
9525 |
|
<blockquote class="text"> |
9526 |
|
<p>MOVE DB_INSTRUMENT <instr> <dst> |
9527 |
|
</p> |
9528 |
|
</blockquote><p> |
9529 |
|
|
9530 |
|
</p> |
9531 |
|
<p>Where <instr> is the absolute path name of the instrument |
9532 |
|
to move and <dst> is the directory where the instrument will |
9533 |
|
be moved to. |
9534 |
|
</p> |
9535 |
|
<p>Possible Answers: |
9536 |
|
</p> |
9537 |
|
<p> |
9538 |
|
</p> |
9539 |
|
<blockquote class="text"> |
9540 |
|
<p>"OK" - |
9541 |
|
</p> |
9542 |
|
<blockquote class="text"> |
9543 |
|
<p>on success |
9544 |
|
</p> |
9545 |
|
</blockquote> |
9546 |
|
|
9547 |
|
|
9548 |
|
<p>"ERR:<error-code>:<error-message>" - |
9549 |
|
</p> |
9550 |
|
<blockquote class="text"> |
9551 |
|
<p>in case the given instrument does not exists, |
9552 |
|
or if an instrument with name equal to the name of the |
9553 |
|
specified instrument already exists in the destination |
9554 |
|
directory. |
9555 |
|
</p> |
9556 |
|
</blockquote> |
9557 |
|
|
9558 |
|
|
9559 |
|
</blockquote><p> |
9560 |
|
|
9561 |
|
</p> |
9562 |
|
<p>Example: |
9563 |
|
</p> |
9564 |
|
<p> |
9565 |
|
</p> |
9566 |
|
<blockquote class="text"> |
9567 |
|
<p>C: "MOVE DB_INSTRUMENT '/Piano Collection/Bosendorfer 290' '/Piano Collection/Acoustic'" |
9568 |
|
</p> |
9569 |
|
<p>S: "OK" |
9570 |
|
</p> |
9571 |
|
</blockquote><p> |
9572 |
|
|
9573 |
|
</p> |
9574 |
|
<a name="COPY DB_INSTRUMENT"></a><br /><hr /> |
9575 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9576 |
|
<a name="rfc.section.6.8.18"></a><h3>6.8.18. |
9577 |
|
Copying instruments</h3> |
9578 |
|
|
9579 |
|
<p>The front-end can copy a specific instrument to another directory by |
9580 |
|
sending the following command: |
9581 |
|
</p> |
9582 |
|
<p> |
9583 |
|
</p> |
9584 |
|
<blockquote class="text"> |
9585 |
|
<p>COPY DB_INSTRUMENT <instr> <dst> |
9586 |
|
</p> |
9587 |
|
</blockquote><p> |
9588 |
|
|
9589 |
|
</p> |
9590 |
|
<p>Where <instr> is the absolute path name of the instrument |
9591 |
|
to copy and <dst> is the directory where the instrument will |
9592 |
|
be copied to. |
9593 |
|
</p> |
9594 |
|
<p>Possible Answers: |
9595 |
|
</p> |
9596 |
|
<p> |
9597 |
|
</p> |
9598 |
|
<blockquote class="text"> |
9599 |
|
<p>"OK" - |
9600 |
|
</p> |
9601 |
|
<blockquote class="text"> |
9602 |
|
<p>on success |
9603 |
|
</p> |
9604 |
|
</blockquote> |
9605 |
|
|
9606 |
|
|
9607 |
|
<p>"ERR:<error-code>:<error-message>" - |
9608 |
|
</p> |
9609 |
|
<blockquote class="text"> |
9610 |
|
<p>in case the given instrument does not exists, |
9611 |
|
or if an instrument with name equal to the name of the |
9612 |
|
specified instrument already exists in the destination |
9613 |
|
directory. |
9614 |
|
</p> |
9615 |
|
</blockquote> |
9616 |
|
|
9617 |
|
|
9618 |
|
</blockquote><p> |
9619 |
|
|
9620 |
|
</p> |
9621 |
|
<p>Example: |
9622 |
|
</p> |
9623 |
|
<p> |
9624 |
|
</p> |
9625 |
|
<blockquote class="text"> |
9626 |
|
<p>C: "COPY DB_INSTRUMENT '/Piano Collection/Bosendorfer 290' '/Acoustic/Pianos/'" |
9627 |
|
</p> |
9628 |
|
<p>S: "OK" |
9629 |
|
</p> |
9630 |
|
</blockquote><p> |
9631 |
|
|
9632 |
|
</p> |
9633 |
|
<a name="SET DB_INSTRUMENT DESCRIPTION"></a><br /><hr /> |
9634 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9635 |
|
<a name="rfc.section.6.8.19"></a><h3>6.8.19. |
9636 |
|
Changing the description of instrument</h3> |
9637 |
|
|
9638 |
|
<p>The front-end can alter the description of a specific |
9639 |
|
instrument by sending the following command: |
9640 |
|
</p> |
9641 |
|
<p> |
9642 |
|
</p> |
9643 |
|
<blockquote class="text"> |
9644 |
|
<p>SET DB_INSTRUMENT DESCRIPTION <instr> <desc> |
9645 |
|
</p> |
9646 |
|
</blockquote><p> |
9647 |
|
|
9648 |
|
</p> |
9649 |
|
<p>Where <instr> is the absolute path name of the instrument and |
9650 |
|
<desc> is the new description for the instrument |
9651 |
|
(encapsulated into apostrophes, supporting escape sequences as described in chapter |
9652 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
9653 |
|
</p> |
9654 |
|
<p>Possible Answers: |
9655 |
|
</p> |
9656 |
|
<p> |
9657 |
|
</p> |
9658 |
|
<blockquote class="text"> |
9659 |
|
<p>"OK" - |
9660 |
|
</p> |
9661 |
|
<blockquote class="text"> |
9662 |
|
<p>on success |
9663 |
|
</p> |
9664 |
|
</blockquote> |
9665 |
|
|
9666 |
|
|
9667 |
|
<p>"ERR:<error-code>:<error-message>" - |
9668 |
|
</p> |
9669 |
|
<blockquote class="text"> |
9670 |
|
<p>in case the given instrument does not exists. |
9671 |
|
</p> |
9672 |
|
</blockquote> |
9673 |
|
|
9674 |
|
|
9675 |
|
</blockquote><p> |
9676 |
|
|
9677 |
|
</p> |
9678 |
|
<p>Example: |
9679 |
|
</p> |
9680 |
|
<p> |
9681 |
|
</p> |
9682 |
|
<blockquote class="text"> |
9683 |
|
<p>C: "SET DB_INSTRUMENT DESCRIPTION '/Piano Collection/Acoustic/Bosendorfer 290' 'No comment :)'" |
9684 |
|
</p> |
9685 |
|
<p>S: "OK" |
9686 |
|
</p> |
9687 |
|
</blockquote><p> |
9688 |
|
|
9689 |
|
</p> |
9690 |
|
<a name="FIND DB_INSTRUMENTS"></a><br /><hr /> |
9691 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9692 |
|
<a name="rfc.section.6.8.20"></a><h3>6.8.20. |
9693 |
|
Finding instruments</h3> |
9694 |
|
|
9695 |
|
<p>The front-end can search for instruments |
9696 |
|
in specific directory by sending the following command: |
9697 |
|
</p> |
9698 |
|
<p> |
9699 |
|
</p> |
9700 |
|
<blockquote class="text"> |
9701 |
|
<p>FIND DB_INSTRUMENTS [NON_RECURSIVE] <dir> <criteria-list> |
9702 |
|
</p> |
9703 |
|
</blockquote><p> |
9704 |
|
|
9705 |
|
</p> |
9706 |
|
<p>Where <dir> should be replaced by the absolute path |
9707 |
|
name of the directory to search in. If NON_RECURSIVE is specified, the |
9708 |
|
directories located in subdirectories of the specified directory will not |
9709 |
|
be searched. <criteria-list> is a list of search criterias |
9710 |
|
in form of "key1=val1 key2=val2 ...". The following criterias are |
9711 |
|
allowed: |
9712 |
|
</p> |
9713 |
|
<p> |
9714 |
|
|
9715 |
|
<p>NAME='<search-string>' |
9716 |
|
</p> |
9717 |
|
<blockquote class="text"> |
9718 |
|
<p>Restricts the search to instruments, which names |
9719 |
|
satisfy the supplied search string (encapsulated into apostrophes, |
9720 |
|
supporting escape sequences as described in chapter |
9721 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
9722 |
|
</p> |
9723 |
|
</blockquote><p> |
9724 |
|
|
9725 |
|
</p> |
9726 |
|
|
9727 |
|
|
9728 |
|
<p>SIZE=[<min>]..[<max>] |
9729 |
|
</p> |
9730 |
|
<blockquote class="text"> |
9731 |
|
<p>Restricts the search to instruments, which |
9732 |
|
size is in the specified range. If <min> is omitted, |
9733 |
|
the search results are restricted to instruments with size less then |
9734 |
|
or equal to <max>. If <max> is omitted, the |
9735 |
|
search is restricted to instruments with size greater then |
9736 |
|
or equal to <min>. |
9737 |
|
</p> |
9738 |
|
</blockquote><p> |
9739 |
|
|
9740 |
|
</p> |
9741 |
|
|
9742 |
|
|
9743 |
|
<p>CREATED='[<date-after>]..[<date-before>]' |
9744 |
|
</p> |
9745 |
|
<blockquote class="text"> |
9746 |
|
<p>Restricts the search to instruments, which creation |
9747 |
|
date satisfies the specified period, where <date-after> |
9748 |
|
and <date-before> are in "YYYY-MM-DD HH:MM:SS" format. |
9749 |
|
If <date-after> is omitted the search is restricted to |
9750 |
|
instruments created before <date-before>. If |
9751 |
|
<date-before> is omitted, the search is restricted |
9752 |
|
to instruments created after <date-after>. |
9753 |
|
</p> |
9754 |
|
</blockquote><p> |
9755 |
|
|
9756 |
|
</p> |
9757 |
|
|
9758 |
|
|
9759 |
|
<p>MODIFIED='[<date-after>]..[<date-before>]' |
9760 |
|
</p> |
9761 |
|
<blockquote class="text"> |
9762 |
|
<p>Restricts the search to instruments, which |
9763 |
|
date of last modification satisfies the specified period, where |
9764 |
|
<date-after> and <date-before> are in "YYYY-MM-DD HH:MM:SS" |
9765 |
|
format. If <date-after> is omitted the search is restricted to |
9766 |
|
instruments, which are last modified before <date-before>. If |
9767 |
|
<date-before> is omitted, the search is restricted to instruments, |
9768 |
|
which are last modified after <date-after>. |
9769 |
|
</p> |
9770 |
|
</blockquote><p> |
9771 |
|
|
9772 |
|
</p> |
9773 |
|
|
9774 |
|
|
9775 |
|
<p>DESCRIPTION='<search-string>' |
9776 |
|
</p> |
9777 |
|
<blockquote class="text"> |
9778 |
|
<p>Restricts the search to instruments with description |
9779 |
|
that satisfies the supplied search string (encapsulated into apostrophes, |
9780 |
|
supporting escape sequences as described in chapter |
9781 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
9782 |
|
</p> |
9783 |
|
</blockquote><p> |
9784 |
|
|
9785 |
|
</p> |
9786 |
|
|
9787 |
|
|
9788 |
|
<p>PRODUCT='<search-string>' |
9789 |
|
</p> |
9790 |
|
<blockquote class="text"> |
9791 |
|
<p>Restricts the search to instruments with product info |
9792 |
|
that satisfies the supplied search string (encapsulated into apostrophes, |
9793 |
|
supporting escape sequences as described in chapter |
9794 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
9795 |
|
</p> |
9796 |
|
</blockquote><p> |
9797 |
|
|
9798 |
|
</p> |
9799 |
|
|
9800 |
|
|
9801 |
|
<p>ARTISTS='<search-string>' |
9802 |
|
</p> |
9803 |
|
<blockquote class="text"> |
9804 |
|
<p>Restricts the search to instruments with artists info |
9805 |
|
that satisfies the supplied search string (encapsulated into apostrophes, |
9806 |
|
supporting escape sequences as described in chapter |
9807 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
9808 |
|
</p> |
9809 |
|
</blockquote><p> |
9810 |
|
|
9811 |
|
</p> |
9812 |
|
|
9813 |
|
|
9814 |
|
<p>KEYWORDS='<search-string>' |
9815 |
|
</p> |
9816 |
|
<blockquote class="text"> |
9817 |
|
<p>Restricts the search to instruments with keyword list |
9818 |
|
that satisfies the supplied search string (encapsulated into apostrophes, |
9819 |
|
supporting escape sequences as described in chapter |
9820 |
|
"<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
9821 |
|
</p> |
9822 |
|
</blockquote><p> |
9823 |
|
|
9824 |
|
</p> |
9825 |
|
|
9826 |
|
|
9827 |
|
<p>IS_DRUM=true | false |
9828 |
|
</p> |
9829 |
|
<blockquote class="text"> |
9830 |
|
<p>Either true or false. Restricts the search to |
9831 |
|
drum kits or chromatic instruments. |
9832 |
|
</p> |
9833 |
|
</blockquote><p> |
9834 |
|
|
9835 |
|
</p> |
9836 |
|
|
9837 |
|
|
9838 |
|
<p>FORMAT_FAMILIES='<format-list>' |
9839 |
|
</p> |
9840 |
|
<blockquote class="text"> |
9841 |
|
<p>Restricts the search to instruments of the supplied format families, |
9842 |
|
where <format-list> is a comma separated list of format families. |
9843 |
|
</p> |
9844 |
|
</blockquote><p> |
9845 |
|
|
9846 |
|
</p> |
9847 |
|
|
9848 |
|
|
9849 |
|
<p>Where <search-string> is either a regular expression, or a |
9850 |
|
word list separated with spaces for OR search and with '+' for AND search. |
9851 |
|
</p> |
9852 |
|
<p>Possible Answers: |
9853 |
|
</p> |
9854 |
|
<p> |
9855 |
|
</p> |
9856 |
|
<blockquote class="text"> |
9857 |
|
<p>A comma separated list with the absolute path names (encapsulated into |
9858 |
|
apostrophes) of all instruments in the specified directory that satisfy |
9859 |
|
the supplied search criterias. |
9860 |
|
</p> |
9861 |
|
<p>"ERR:<error-code>:<error-message>" - |
9862 |
|
</p> |
9863 |
|
<blockquote class="text"> |
9864 |
|
<p>if the given directory does not exist. |
9865 |
|
</p> |
9866 |
|
</blockquote> |
9867 |
|
|
9868 |
|
|
9869 |
|
</blockquote><p> |
9870 |
|
|
9871 |
|
</p> |
9872 |
|
<p>Example: |
9873 |
|
</p> |
9874 |
|
<p> |
9875 |
|
</p> |
9876 |
|
<blockquote class="text"> |
9877 |
|
<p>C: "FIND DB_INSTRUMENTS '/Piano Collection' NAME='bosendorfer+290'" |
9878 |
|
</p> |
9879 |
|
<p>S: "'/Piano Collection/Bosendorfer 290'" |
9880 |
|
</p> |
9881 |
|
</blockquote><p> |
9882 |
|
|
9883 |
|
</p> |
9884 |
|
<p> |
9885 |
|
</p> |
9886 |
|
<blockquote class="text"> |
9887 |
|
<p>C: "FIND DB_INSTRUMENTS '/Piano Collection' CREATED='2007-04-01 09:30:13..'" |
9888 |
|
</p> |
9889 |
|
<p>S: "'/Piano Collection/Bosendorfer 290','/Piano Collection/Steinway D'" |
9890 |
|
</p> |
9891 |
|
</blockquote><p> |
9892 |
|
|
9893 |
|
</p> |
9894 |
|
<a name="GET DB_INSTRUMENTS_JOB INFO"></a><br /><hr /> |
9895 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9896 |
|
<a name="rfc.section.6.8.21"></a><h3>6.8.21. |
9897 |
|
Getting job status information</h3> |
9898 |
|
|
9899 |
|
<p>The front-end can ask for the current status of a |
9900 |
|
particular database instruments job by sending the following command: |
9901 |
|
</p> |
9902 |
|
<p> |
9903 |
|
</p> |
9904 |
|
<blockquote class="text"> |
9905 |
|
<p>GET DB_INSTRUMENTS_JOB INFO <job-id> |
9906 |
|
</p> |
9907 |
|
</blockquote><p> |
9908 |
|
|
9909 |
|
</p> |
9910 |
|
<p>Where <job-id> should be replaced by the numerical ID |
9911 |
|
of the job the front-end is interested in. |
9912 |
|
</p> |
9913 |
|
<p>Possible Answers: |
9914 |
|
</p> |
9915 |
|
<p> |
9916 |
|
</p> |
9917 |
|
<blockquote class="text"> |
9918 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
9919 |
|
Each answer line begins with the settings category name |
9920 |
|
followed by a colon and then a space character <SP> and finally |
9921 |
|
the info character string to that setting category. At the |
9922 |
|
moment the following categories are defined: |
9923 |
|
</p> |
9924 |
|
<p> |
9925 |
|
</p> |
9926 |
|
<blockquote class="text"> |
9927 |
|
<p>FILES_TOTAL - |
9928 |
|
</p> |
9929 |
|
<blockquote class="text"> |
9930 |
|
<p>The total number of files scheduled for scanning |
9931 |
|
</p> |
9932 |
|
</blockquote> |
9933 |
|
|
9934 |
|
|
9935 |
|
<p>FILES_SCANNED - |
9936 |
|
</p> |
9937 |
|
<blockquote class="text"> |
9938 |
|
<p>The current number of scanned files |
9939 |
|
</p> |
9940 |
|
</blockquote> |
9941 |
|
|
9942 |
|
|
9943 |
|
<p>SCANNING - |
9944 |
|
</p> |
9945 |
|
<blockquote class="text"> |
9946 |
|
<p>The absolute path name of the file which is currently |
9947 |
|
being scanned |
9948 |
|
</p> |
9949 |
|
</blockquote> |
9950 |
|
|
9951 |
|
|
9952 |
|
<p>STATUS - |
9953 |
|
</p> |
9954 |
|
<blockquote class="text"> |
9955 |
|
<p>An integer value between 0 and 100 indicating the |
9956 |
|
scanning progress percentage of the file which is |
9957 |
|
currently being scanned |
9958 |
|
</p> |
9959 |
|
</blockquote> |
9960 |
|
|
9961 |
|
|
9962 |
|
</blockquote> |
9963 |
|
|
9964 |
|
|
9965 |
|
</blockquote><p> |
9966 |
|
|
9967 |
|
</p> |
9968 |
|
<p>The mentioned fields above don't have to be in particular order. |
9969 |
|
</p> |
9970 |
|
<p>Example: |
9971 |
|
</p> |
9972 |
|
<p> |
9973 |
|
</p> |
9974 |
|
<blockquote class="text"> |
9975 |
|
<p>C: "GET DB_INSTRUMENTS_JOB INFO 2" |
9976 |
|
</p> |
9977 |
|
<p>S: "FILES_TOTAL: 12" |
9978 |
|
</p> |
9979 |
|
<p> "FILES_SCANNED: 7" |
9980 |
|
</p> |
9981 |
|
<p> "SCANNING: /home/me/gigs/Bosendorfer 290.gig" |
9982 |
|
</p> |
9983 |
|
<p> "STATUS: 42" |
9984 |
|
</p> |
9985 |
|
<p> "." |
9986 |
|
</p> |
9987 |
|
</blockquote><p> |
9988 |
|
|
9989 |
|
</p> |
9990 |
|
<a name="FORMAT INSTRUMENTS_DB"></a><br /><hr /> |
9991 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
9992 |
|
<a name="rfc.section.6.8.22"></a><h3>6.8.22. |
9993 |
|
Formatting the instruments database</h3> |
9994 |
|
|
9995 |
|
<p>The front-end can remove all instruments and directories and re-create |
9996 |
|
the instruments database structure (e.g., in case of a database corruption) |
9997 |
|
by sending the following command: |
9998 |
|
</p> |
9999 |
|
<p> |
10000 |
|
</p> |
10001 |
|
<blockquote class="text"> |
10002 |
|
<p>FORMAT INSTRUMENTS_DB |
10003 |
|
</p> |
10004 |
|
</blockquote><p> |
10005 |
|
|
10006 |
|
</p> |
10007 |
|
<p>Possible Answers: |
10008 |
|
</p> |
10009 |
|
<p> |
10010 |
|
</p> |
10011 |
|
<blockquote class="text"> |
10012 |
|
<p>"OK" - |
10013 |
|
</p> |
10014 |
|
<blockquote class="text"> |
10015 |
|
<p>on success |
10016 |
|
</p> |
10017 |
|
</blockquote> |
10018 |
|
|
10019 |
|
|
10020 |
|
<p>"ERR:<error-code>:<error-message>" - |
10021 |
|
</p> |
10022 |
|
<blockquote class="text"> |
10023 |
|
<p>If the formatting of the instruments database |
10024 |
|
failed. |
10025 |
|
</p> |
10026 |
|
</blockquote> |
10027 |
|
|
10028 |
|
|
10029 |
|
</blockquote><p> |
10030 |
|
|
10031 |
|
</p> |
10032 |
|
<a name="FIND LOST DB_INSTRUMENT_FILES"></a><br /><hr /> |
10033 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10034 |
|
<a name="rfc.section.6.8.23"></a><h3>6.8.23. |
10035 |
|
Checking for lost instrument files</h3> |
10036 |
|
|
10037 |
|
<p>The front-end can retrieve the list of all instrument files in the instruments database |
10038 |
|
that don't exist in the filesystem by sending the following command: |
10039 |
|
</p> |
10040 |
|
<p> |
10041 |
|
</p> |
10042 |
|
<blockquote class="text"> |
10043 |
|
<p>FIND LOST DB_INSTRUMENT_FILES |
10044 |
|
</p> |
10045 |
|
</blockquote><p> |
10046 |
|
|
10047 |
|
</p> |
10048 |
|
<p>Possible Answers: |
10049 |
|
</p> |
10050 |
|
<p> |
10051 |
|
</p> |
10052 |
|
<blockquote class="text"> |
10053 |
|
<p>A comma separated list with the absolute path names |
10054 |
|
(encapsulated into apostrophes) of all lost instrument files. |
10055 |
|
</p> |
10056 |
|
<p>"ERR:<error-code>:<error-message>" - |
10057 |
|
</p> |
10058 |
|
<blockquote class="text"> |
10059 |
|
<p>in case it failed, providing an appropriate error code and error message. |
10060 |
|
</p> |
10061 |
|
</blockquote> |
10062 |
|
|
10063 |
|
|
10064 |
|
</blockquote><p> |
10065 |
|
|
10066 |
|
</p> |
10067 |
|
<p>Example: |
10068 |
|
</p> |
10069 |
|
<p> |
10070 |
|
</p> |
10071 |
|
<blockquote class="text"> |
10072 |
|
<p>C: "FIND LOST DB_INSTRUMENT_FILES" |
10073 |
|
</p> |
10074 |
|
<p>S: "'/gigs/Bosendorfer 290.gig','/gigs/Steinway D.gig','/gigs/Free Piano.gig'" |
10075 |
|
</p> |
10076 |
|
</blockquote><p> |
10077 |
|
|
10078 |
|
</p> |
10079 |
|
<a name="SET DB_INSTRUMENT FILE_PATH"></a><br /><hr /> |
10080 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10081 |
|
<a name="rfc.section.6.8.24"></a><h3>6.8.24. |
10082 |
|
Replacing an instrument file</h3> |
10083 |
|
|
10084 |
|
<p>The front-end can substitute all occurrences of an instrument file |
10085 |
|
in the instruments database with a new one by sending the following command: |
10086 |
|
</p> |
10087 |
|
<p> |
10088 |
|
</p> |
10089 |
|
<blockquote class="text"> |
10090 |
|
<p>SET DB_INSTRUMENT FILE_PATH <old_path> <new_path> |
10091 |
|
</p> |
10092 |
|
</blockquote><p> |
10093 |
|
|
10094 |
|
</p> |
10095 |
|
<p>Where <old_path> is the absolute path name of the instrument file |
10096 |
|
to substitute with <new_path>. |
10097 |
|
</p> |
10098 |
|
<p>Possible Answers: |
10099 |
|
</p> |
10100 |
|
<p> |
10101 |
|
</p> |
10102 |
|
<blockquote class="text"> |
10103 |
|
<p>"OK" - |
10104 |
|
</p> |
10105 |
|
<blockquote class="text"> |
10106 |
|
<p>on success |
10107 |
|
</p> |
10108 |
|
</blockquote> |
10109 |
|
|
10110 |
|
|
10111 |
|
<p>"ERR:<error-code>:<error-message>" - |
10112 |
|
</p> |
10113 |
|
<blockquote class="text"> |
10114 |
|
<p>in case it failed, providing an appropriate error code and error message. |
10115 |
|
</p> |
10116 |
|
</blockquote> |
10117 |
|
|
10118 |
|
|
10119 |
|
</blockquote><p> |
10120 |
|
|
10121 |
|
</p> |
10122 |
|
<p>Example: |
10123 |
|
</p> |
10124 |
|
<p> |
10125 |
|
</p> |
10126 |
|
<blockquote class="text"> |
10127 |
|
<p>C: "SET DB_INSTRUMENT FILE_PATH '/gigs/Bosendorfer 290.gig' '/gigs/pianos/Bosendorfer 290.gig'" |
10128 |
|
</p> |
10129 |
|
<p>S: "OK" |
10130 |
|
</p> |
10131 |
|
</blockquote><p> |
10132 |
|
|
10133 |
|
</p> |
10134 |
|
<a name="editing_instruments"></a><br /><hr /> |
10135 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10136 |
|
<a name="rfc.section.6.9"></a><h3>6.9. |
10137 |
|
Editing Instruments</h3> |
10138 |
|
|
10139 |
|
<p>The sampler allows to edit instruments while playing with the |
10140 |
|
sampler by spawning an external (3rd party) instrument editor |
10141 |
|
application for a given instrument. The 3rd party instrument |
10142 |
|
editor applications have to place a respective plugin DLL file |
10143 |
|
into the sampler's plugins directory. The sampler will |
10144 |
|
automatically try to load all plugin DLLs in that directory on |
10145 |
|
startup and only on startup! |
10146 |
|
</p> |
10147 |
|
<p>At the moment there is only one command for this feature set, |
10148 |
|
but this will most probably change in future. |
10149 |
|
</p> |
10150 |
|
<a name="EDIT INSTRUMENT"></a><br /><hr /> |
10151 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10152 |
|
<a name="rfc.section.6.9.1"></a><h3>6.9.1. |
10153 |
|
Opening an appropriate instrument editor application</h3> |
10154 |
|
|
10155 |
|
<p>The front-end can request to open an appropriate instrument |
10156 |
|
editor application by sending the following command: |
10157 |
|
</p> |
10158 |
|
<p> |
10159 |
|
</p> |
10160 |
|
<blockquote class="text"> |
10161 |
|
<p>EDIT CHANNEL INSTRUMENT <sampler-channel> |
10162 |
|
</p> |
10163 |
|
</blockquote><p> |
10164 |
|
|
10165 |
|
</p> |
10166 |
|
<p>Where <sampler-channel> should be replaced by the |
10167 |
|
number of the sampler channel as given by the |
10168 |
|
<a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a> |
10169 |
|
or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> |
10170 |
|
command. |
10171 |
|
</p> |
10172 |
|
<p>The sampler will try to ask all registered instrument |
10173 |
|
editors (or to be more specific: their sampler plugins) |
10174 |
|
whether they are capable to handle the instrument on the |
10175 |
|
given sampler channel. The sampler will simply use the first |
10176 |
|
instrument editor application which replied with a positive |
10177 |
|
answer and spawn that instrument editor application within |
10178 |
|
the sampler's process and provide that application access |
10179 |
|
to the instrument's data structures, so both applications |
10180 |
|
can share and access the same instruments data at the same |
10181 |
|
time, thus allowing to immediately hear changes with the |
10182 |
|
sampler made by the instrument editor. |
10183 |
|
</p> |
10184 |
|
<p>Note: consequently instrument editors are always spawned |
10185 |
|
locally on the same machine where the sampler is running |
10186 |
|
on! |
10187 |
|
</p> |
10188 |
|
<p>Possible Answers: |
10189 |
|
</p> |
10190 |
|
<p> |
10191 |
|
</p> |
10192 |
|
<blockquote class="text"> |
10193 |
|
<p>"OK" - |
10194 |
|
</p> |
10195 |
|
<blockquote class="text"> |
10196 |
|
<p>when an appropriate instrument editor was |
10197 |
|
launched |
10198 |
|
</p> |
10199 |
|
</blockquote> |
10200 |
|
|
10201 |
|
|
10202 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
10203 |
|
</p> |
10204 |
|
<blockquote class="text"> |
10205 |
|
<p>when an appropriate instrument editor was |
10206 |
|
launched, but there are noteworthy issues |
10207 |
|
</p> |
10208 |
|
</blockquote> |
10209 |
|
|
10210 |
|
|
10211 |
|
<p>"ERR:<error-code>:<error-message>" - |
10212 |
|
</p> |
10213 |
|
<blockquote class="text"> |
10214 |
|
<p>when an appropriate instrument editor |
10215 |
|
could not be launched |
10216 |
|
</p> |
10217 |
|
</blockquote> |
10218 |
|
|
10219 |
|
|
10220 |
|
</blockquote><p> |
10221 |
|
|
10222 |
|
</p> |
10223 |
|
<p>Examples: |
10224 |
|
</p> |
10225 |
|
<p> |
10226 |
|
</p> |
10227 |
|
<blockquote class="text"> |
10228 |
|
<p>C: "EDIT CHANNEL INSTRUMENT 0" |
10229 |
|
</p> |
10230 |
|
<p>S: "OK" |
10231 |
|
</p> |
10232 |
|
</blockquote><p> |
10233 |
|
|
10234 |
|
</p> |
10235 |
|
<a name="file_management"></a><br /><hr /> |
10236 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10237 |
|
<a name="rfc.section.6.10"></a><h3>6.10. |
10238 |
|
Managing Files</h3> |
10239 |
|
|
10240 |
|
<p>You can query detailed informations about files located |
10241 |
|
at the same system where the sampler instance is running on. |
10242 |
|
Using this command set allows to retrieve file informations |
10243 |
|
even remotely from another machine. |
10244 |
|
</p> |
10245 |
|
<a name="GET FILE INSTRUMENTS"></a><br /><hr /> |
10246 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10247 |
|
<a name="rfc.section.6.10.1"></a><h3>6.10.1. |
10248 |
|
Retrieving amount of instruments of a file</h3> |
10249 |
|
|
10250 |
|
<p>The front-end can retrieve the amount of instruments |
10251 |
|
within a given instrument file by sending the |
10252 |
|
following command: |
10253 |
|
</p> |
10254 |
|
<p> |
10255 |
|
</p> |
10256 |
|
<blockquote class="text"> |
10257 |
|
<p>GET FILE INSTRUMENTS <filename> |
10258 |
|
</p> |
10259 |
|
</blockquote><p> |
10260 |
|
|
10261 |
|
</p> |
10262 |
|
<p>Where <filename> is the name of the instrument |
10263 |
|
file (encapsulated into apostrophes, supporting escape |
10264 |
|
sequences as described in chapter |
10265 |
|
"<a class='info' href='#character_set'>Character Set and Escape |
10266 |
|
Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
10267 |
|
</p> |
10268 |
|
<p>The sampler will try to ask all sampler engines, |
10269 |
|
whether they support the given file and ask the first |
10270 |
|
engine with a positive answer for the amount of |
10271 |
|
instruments. |
10272 |
|
</p> |
10273 |
|
<p>Possible Answers: |
10274 |
|
</p> |
10275 |
|
<p> |
10276 |
|
</p> |
10277 |
|
<blockquote class="text"> |
10278 |
|
<p>On success, the sampler will answer by |
10279 |
|
returning the amount of instruments. |
10280 |
|
|
10281 |
|
</p> |
10282 |
|
<p>"ERR:<error-code>:<error-message>" - |
10283 |
|
</p> |
10284 |
|
<blockquote class="text"> |
10285 |
|
<p>if the file could not be handled |
10286 |
|
</p> |
10287 |
|
</blockquote> |
10288 |
|
|
10289 |
|
|
10290 |
|
</blockquote><p> |
10291 |
|
|
10292 |
|
</p> |
10293 |
|
<p>Examples: |
10294 |
|
</p> |
10295 |
|
<p> |
10296 |
|
</p> |
10297 |
|
<blockquote class="text"> |
10298 |
|
<p>C: "GET FILE INSTRUMENTS 'D:/Sounds/Foo.gig'" |
10299 |
|
</p> |
10300 |
|
<p>S: "10" |
10301 |
|
</p> |
10302 |
|
</blockquote><p> |
10303 |
|
|
10304 |
|
</p> |
10305 |
|
<a name="LIST FILE INSTRUMENTS"></a><br /><hr /> |
10306 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10307 |
|
<a name="rfc.section.6.10.2"></a><h3>6.10.2. |
10308 |
|
Retrieving all instruments of a file</h3> |
10309 |
|
|
10310 |
|
<p>The front-end can retrieve a list of all instruments |
10311 |
|
within a given instrument file by sending the |
10312 |
|
following command: |
10313 |
|
</p> |
10314 |
|
<p> |
10315 |
|
</p> |
10316 |
|
<blockquote class="text"> |
10317 |
|
<p>LIST FILE INSTRUMENTS <filename> |
10318 |
|
</p> |
10319 |
|
</blockquote><p> |
10320 |
|
|
10321 |
|
</p> |
10322 |
|
<p>Where <filename> is the name of the instrument |
10323 |
|
file (encapsulated into apostrophes, supporting escape |
10324 |
|
sequences as described in chapter |
10325 |
|
"<a class='info' href='#character_set'>Character Set and Escape |
10326 |
|
Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>"). |
10327 |
|
</p> |
10328 |
|
<p>The sampler will try to ask all sampler engines, |
10329 |
|
whether they support the given file and ask the first |
10330 |
|
engine with a positive answer for a list of IDs for the |
10331 |
|
instruments in the given file. |
10332 |
|
</p> |
10333 |
|
<p>Possible Answers: |
10334 |
|
</p> |
10335 |
|
<p> |
10336 |
|
</p> |
10337 |
|
<blockquote class="text"> |
10338 |
|
<p>On success, the sampler will answer by |
10339 |
|
returning a comma separated list of |
10340 |
|
instrument IDs. |
10341 |
|
|
10342 |
|
</p> |
10343 |
|
<p>"ERR:<error-code>:<error-message>" - |
10344 |
|
</p> |
10345 |
|
<blockquote class="text"> |
10346 |
|
<p>if the file could not be handled |
10347 |
|
</p> |
10348 |
|
</blockquote> |
10349 |
|
|
10350 |
|
|
10351 |
|
</blockquote><p> |
10352 |
|
|
10353 |
|
</p> |
10354 |
|
<p>Examples: |
10355 |
|
</p> |
10356 |
|
<p> |
10357 |
|
</p> |
10358 |
|
<blockquote class="text"> |
10359 |
|
<p>C: "LIST FILE INSTRUMENTS 'D:/Sounds/Foo.gig'" |
10360 |
|
</p> |
10361 |
|
<p>S: "0,1,2,3,4,5,6,7,8,9" |
10362 |
|
</p> |
10363 |
|
</blockquote><p> |
10364 |
|
|
10365 |
|
</p> |
10366 |
|
<a name="GET FILE INSTRUMENT INFO"></a><br /><hr /> |
10367 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10368 |
|
<a name="rfc.section.6.10.3"></a><h3>6.10.3. |
10369 |
|
Retrieving informations about one instrument in a file</h3> |
10370 |
|
|
10371 |
|
<p>The front-end can retrieve detailed informations |
10372 |
|
about a specific instrument within a given instrument |
10373 |
|
file by sending the following command: |
10374 |
|
</p> |
10375 |
|
<p> |
10376 |
|
</p> |
10377 |
|
<blockquote class="text"> |
10378 |
|
<p>GET FILE INSTRUMENT INFO <filename> |
10379 |
|
<instr-id> |
10380 |
|
</p> |
10381 |
|
</blockquote><p> |
10382 |
|
|
10383 |
|
</p> |
10384 |
|
<p>Where <filename> is the name of the instrument |
10385 |
|
file (encapsulated into apostrophes, supporting escape |
10386 |
|
sequences as described in chapter |
10387 |
|
"<a class='info' href='#character_set'>Character Set and Escape |
10388 |
|
Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>") and <instr-id> is the numeric |
10389 |
|
instrument ID as returned by the |
10390 |
|
<a class='info' href='#LIST FILE INSTRUMENTS'>"LIST FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving all instruments of a file</span><span>)</span></a> command. |
10391 |
|
</p> |
10392 |
|
<p>The sampler will try to ask all sampler engines, |
10393 |
|
whether they support the given file and ask the first |
10394 |
|
engine with a positive answer for informations about the |
10395 |
|
specific instrument in the given file. |
10396 |
|
</p> |
10397 |
|
<p>Possible Answers: |
10398 |
|
</p> |
10399 |
|
<p> |
10400 |
|
</p> |
10401 |
|
<blockquote class="text"> |
10402 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
10403 |
|
Each answer line begins with the settings category name |
10404 |
|
followed by a colon and then a space character <SP> and finally |
10405 |
|
the info character string to that setting category. At the |
10406 |
|
moment the following categories are defined: |
10407 |
|
</p> |
10408 |
|
<p> |
10409 |
|
</p> |
10410 |
|
<blockquote class="text"> |
10411 |
|
<p>NAME - |
10412 |
|
</p> |
10413 |
|
<blockquote class="text"> |
10414 |
|
<p>name of the instrument as |
10415 |
|
stored in the instrument file |
10416 |
|
</p> |
10417 |
|
</blockquote> |
10418 |
|
|
10419 |
|
|
10420 |
|
<p>FORMAT_FAMILY - |
10421 |
|
</p> |
10422 |
|
<blockquote class="text"> |
10423 |
|
<p>name of the sampler format |
10424 |
|
of the given instrument |
10425 |
|
</p> |
10426 |
|
</blockquote> |
10427 |
|
|
10428 |
|
|
10429 |
|
<p>FORMAT_VERSION - |
10430 |
|
</p> |
10431 |
|
<blockquote class="text"> |
10432 |
|
<p>version of the sampler format |
10433 |
|
the instrumen is stored as |
10434 |
|
</p> |
10435 |
|
</blockquote> |
10436 |
|
|
10437 |
|
|
10438 |
|
<p>PRODUCT - |
10439 |
|
</p> |
10440 |
|
<blockquote class="text"> |
10441 |
|
<p>official product name of the |
10442 |
|
instrument as stored in the file |
10443 |
|
|
10444 |
|
</p> |
10445 |
|
</blockquote> |
10446 |
|
|
10447 |
|
|
10448 |
|
<p>ARTISTS - |
10449 |
|
</p> |
10450 |
|
<blockquote class="text"> |
10451 |
|
<p>artists / sample library |
10452 |
|
vendor of the instrument |
10453 |
|
</p> |
10454 |
|
</blockquote> |
10455 |
|
|
10456 |
|
|
10457 |
|
<p>KEY_BINDINGS - |
10458 |
|
</p> |
10459 |
|
<blockquote class="text"> |
10460 |
|
<p>comma separated list of integer values representing |
10461 |
|
the instrument's key mapping in the range between 0 .. 127, |
10462 |
|
reflecting the analog meaning of the MIDI specification. |
10463 |
|
</p> |
10464 |
|
</blockquote> |
10465 |
|
|
10466 |
|
|
10467 |
|
<p>KEYSWITCH_BINDINGS - |
10468 |
|
</p> |
10469 |
|
<blockquote class="text"> |
10470 |
|
<p>comma separated list of integer values representing |
10471 |
|
the instrument's keyswitch mapping in the range between 0 .. 127, |
10472 |
|
reflecting the analog meaning of the MIDI specification. |
10473 |
|
</p> |
10474 |
|
</blockquote> |
10475 |
|
|
10476 |
|
|
10477 |
|
</blockquote> |
10478 |
|
|
10479 |
|
|
10480 |
|
</blockquote><p> |
10481 |
|
|
10482 |
|
</p> |
10483 |
|
<p>The mentioned fields above don't have to be in particular order. |
10484 |
|
</p> |
10485 |
|
<p>Example: |
10486 |
|
</p> |
10487 |
|
<p> |
10488 |
|
</p> |
10489 |
|
<blockquote class="text"> |
10490 |
|
<p>C: "GET FILE INSTRUMENT INFO 'D:/Sounds/Foo.gig' 0" |
10491 |
|
</p> |
10492 |
|
<p>S: "NAME: Lunatic Loops" |
10493 |
|
</p> |
10494 |
|
<p> "FORMAT_FAMILY: GIG" |
10495 |
|
</p> |
10496 |
|
<p> "FORMAT_VERSION: 3" |
10497 |
|
</p> |
10498 |
|
<p> "PRODUCT: The Backbone Bongo Beats" |
10499 |
|
</p> |
10500 |
|
<p> "ARTISTS: Jimmy the Fish" |
10501 |
|
</p> |
10502 |
|
<p> "." |
10503 |
|
</p> |
10504 |
|
</blockquote><p> |
10505 |
|
|
10506 |
|
</p> |
10507 |
|
<a name="effects"></a><br /><hr /> |
10508 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10509 |
|
<a name="rfc.section.6.11"></a><h3>6.11. |
10510 |
|
Managing Effects</h3> |
10511 |
|
|
10512 |
|
<p>Audio effects (e.g. reverb, delay, compression) can be |
10513 |
|
applied to the audio signals generated by the sampler. The |
10514 |
|
sampler usually provides a set of internal audio effects for |
10515 |
|
this task. The exact set of effects depends on the availability |
10516 |
|
of third party effect plugins installed on the system where the |
10517 |
|
sampler runs on. |
10518 |
|
</p> |
10519 |
|
<p>At the moment only "send effects" are supported. Support for |
10520 |
|
"insert effects" and "master effects" is planned to be added at |
10521 |
|
a later point. |
10522 |
|
</p> |
10523 |
|
<p>The following commands allow to retrieve the set of internal |
10524 |
|
effects available to the sampler, detailed informations about |
10525 |
|
those effects and to create and destroy instances of such |
10526 |
|
effects. After an instance of an effect is created, the effect |
10527 |
|
instance can be inserted into the audio signal path of the |
10528 |
|
sampler, e.g. as send effect. |
10529 |
|
</p> |
10530 |
|
<p>The sampler allows to create an arbitrary amount of so called |
10531 |
|
send effect chains. Each effect chain can host an arbitrary |
10532 |
|
amount of effect instances. The output of the first effect |
10533 |
|
instance in an effect chain is fed to the input of the second |
10534 |
|
effect instance of the chain and so on. So effects in one chain |
10535 |
|
are processed sequentially. Send effect chains however are |
10536 |
|
processed in parallel to other send effect chains. Audio signals |
10537 |
|
of sampler channels are fed to send effects by creating FX sends |
10538 |
|
to the respective sampler channel and assigning a destination |
10539 |
|
send effect to that FX by using the |
10540 |
|
<a class='info' href='#SET FX_SEND EFFECT'>"SET FX_SEND EFFECT"<span> (</span><span class='info'>Assigning destination effect to an effect send</span><span>)</span></a> |
10541 |
|
command. The latter allows to route the FX send to the beginning |
10542 |
|
of a send effect chain, as well as directly to any other |
10543 |
|
position of the send effect chain. |
10544 |
|
</p> |
10545 |
|
<a name="GET AVAILABLE_EFFECTS"></a><br /><hr /> |
10546 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10547 |
|
<a name="rfc.section.6.11.1"></a><h3>6.11.1. |
10548 |
|
Retrieve amount of available effects</h3> |
10549 |
|
|
10550 |
|
<p>The front-end can retrieve the amount of internal |
10551 |
|
effects, available to the sampler by sending |
10552 |
|
the following command: |
10553 |
|
</p> |
10554 |
|
<p> |
10555 |
|
</p> |
10556 |
|
<blockquote class="text"> |
10557 |
|
<p>GET AVAILABLE_EFFECTS |
10558 |
|
</p> |
10559 |
|
</blockquote><p> |
10560 |
|
|
10561 |
|
</p> |
10562 |
|
<p>Possible Answers: |
10563 |
|
</p> |
10564 |
|
<p> |
10565 |
|
</p> |
10566 |
|
<blockquote class="text"> |
10567 |
|
<p>The sampler will answer by returning the current |
10568 |
|
number of effects available to the sampler. |
10569 |
|
</p> |
10570 |
|
</blockquote><p> |
10571 |
|
|
10572 |
|
</p> |
10573 |
|
<p>Examples: |
10574 |
|
</p> |
10575 |
|
<p> |
10576 |
|
</p> |
10577 |
|
<blockquote class="text"> |
10578 |
|
<p>C: "GET AVAILABLE_EFFECTS" |
10579 |
|
</p> |
10580 |
|
<p>S: "129" |
10581 |
|
</p> |
10582 |
|
</blockquote><p> |
10583 |
|
|
10584 |
|
</p> |
10585 |
|
<a name="LIST AVAILABLE_EFFECTS"></a><br /><hr /> |
10586 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10587 |
|
<a name="rfc.section.6.11.2"></a><h3>6.11.2. |
10588 |
|
Get list of available effects</h3> |
10589 |
|
|
10590 |
|
<p>The set of available internal effects can change at |
10591 |
|
runtime. The front-end can retrieve the list of internal |
10592 |
|
effects, available to the sampler by sending the following |
10593 |
|
command: |
10594 |
|
</p> |
10595 |
|
<p> |
10596 |
|
</p> |
10597 |
|
<blockquote class="text"> |
10598 |
|
<p>LIST AVAILABLE_EFFECTS |
10599 |
|
</p> |
10600 |
|
</blockquote><p> |
10601 |
|
|
10602 |
|
</p> |
10603 |
|
<p>Possible Answers: |
10604 |
|
</p> |
10605 |
|
<p> |
10606 |
|
</p> |
10607 |
|
<blockquote class="text"> |
10608 |
|
<p>The sampler will answer by returning a comma |
10609 |
|
separated list with numerical IDs of effects. Note: |
10610 |
|
the numercial ID of an effect is generated by the |
10611 |
|
sampler for the current moment. The numerical ID of |
10612 |
|
the same effect can change at runtime, e.g. when the |
10613 |
|
user requests a rescan of available effect plugins. |
10614 |
|
|
10615 |
|
</p> |
10616 |
|
</blockquote><p> |
10617 |
|
|
10618 |
|
</p> |
10619 |
|
<p>Example: |
10620 |
|
</p> |
10621 |
|
<p> |
10622 |
|
</p> |
10623 |
|
<blockquote class="text"> |
10624 |
|
<p>C: "LIST AVAILABLE_EFFECTS" |
10625 |
|
</p> |
10626 |
|
<p>S: "5,6,7,120,121,122,123,124" |
10627 |
|
</p> |
10628 |
|
</blockquote><p> |
10629 |
|
|
10630 |
|
</p> |
10631 |
|
<a name="GET EFFECT INFO"></a><br /><hr /> |
10632 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10633 |
|
<a name="rfc.section.6.11.3"></a><h3>6.11.3. |
10634 |
|
Retrieving general information about an effect</h3> |
10635 |
|
|
10636 |
|
<p>The front-end can ask for general informations about an |
10637 |
|
effect by sending the following command: |
10638 |
|
</p> |
10639 |
|
<p> |
10640 |
|
</p> |
10641 |
|
<blockquote class="text"> |
10642 |
|
<p>GET EFFECT INFO <effect-index> |
10643 |
|
</p> |
10644 |
|
</blockquote><p> |
10645 |
|
|
10646 |
|
</p> |
10647 |
|
<p>Where <effect-index> is the numerical ID of an |
10648 |
|
effect as returned by the |
10649 |
|
<a class='info' href='#LIST AVAILABLE_EFFECTS'>"LIST AVAILABLE_EFFECTS"<span> (</span><span class='info'>Get list of available effects</span><span>)</span></a> |
10650 |
|
command. |
10651 |
|
</p> |
10652 |
|
<p>Possible Answers: |
10653 |
|
</p> |
10654 |
|
<p> |
10655 |
|
</p> |
10656 |
|
<blockquote class="text"> |
10657 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
10658 |
|
Each answer line begins with the effect information |
10659 |
|
category name, followed by a colon and then a space |
10660 |
|
character <SP> and finally the info character |
10661 |
|
string to that effect information category. At the |
10662 |
|
moment the following categories are defined: |
10663 |
|
</p> |
10664 |
|
<p> |
10665 |
|
</p> |
10666 |
|
<blockquote class="text"> |
10667 |
|
<p>SYSTEM - |
10668 |
|
</p> |
10669 |
|
<blockquote class="text"> |
10670 |
|
<p>name of the effect plugin system |
10671 |
|
the effect is based on |
10672 |
|
(e.g. "LADSPA") |
10673 |
|
</p> |
10674 |
|
</blockquote> |
10675 |
|
|
10676 |
|
|
10677 |
|
<p>MODULE - |
10678 |
|
</p> |
10679 |
|
<blockquote class="text"> |
10680 |
|
<p>module of the effect plugin |
10681 |
|
system that contains this effect, |
10682 |
|
the module is usually the |
10683 |
|
dynamic-linked library (DLL) |
10684 |
|
filename of the effect plugin, |
10685 |
|
including full path (note that this |
10686 |
|
filename may contain |
10687 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
10688 |
|
</p> |
10689 |
|
</blockquote> |
10690 |
|
|
10691 |
|
|
10692 |
|
<p>NAME - |
10693 |
|
</p> |
10694 |
|
<blockquote class="text"> |
10695 |
|
<p>character string defining the |
10696 |
|
unique name of the effect within its |
10697 |
|
module (note that the character |
10698 |
|
string may contain |
10699 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
10700 |
|
</p> |
10701 |
|
</blockquote> |
10702 |
|
|
10703 |
|
|
10704 |
|
<p>DESCRIPTION - |
10705 |
|
</p> |
10706 |
|
<blockquote class="text"> |
10707 |
|
<p>human readable name of the |
10708 |
|
effect, intended to be displayed in |
10709 |
|
user interfaces (note that the |
10710 |
|
character string may contain |
10711 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
10712 |
|
</p> |
10713 |
|
</blockquote> |
10714 |
|
|
10715 |
|
|
10716 |
|
</blockquote> |
10717 |
|
|
10718 |
|
|
10719 |
|
</blockquote><p> |
10720 |
|
|
10721 |
|
</p> |
10722 |
|
<p>The mentioned fields above don't have to be in particular order. |
10723 |
|
</p> |
10724 |
|
<p>Example: |
10725 |
|
</p> |
10726 |
|
<p> |
10727 |
|
</p> |
10728 |
|
<blockquote class="text"> |
10729 |
|
<p>C: "GET EFFECT INFO 121" |
10730 |
|
</p> |
10731 |
|
<p>S: "SYSTEM: LADSPA" |
10732 |
|
</p> |
10733 |
|
<p> "MODULE: /usr/lib/ladspa/lowpass_iir_1891.so" |
10734 |
|
</p> |
10735 |
|
<p> "NAME: lowpass_iir" |
10736 |
|
</p> |
10737 |
|
<p> "DESCRIPTION: Glame Lowpass Filter" |
10738 |
|
</p> |
10739 |
|
<p> "." |
10740 |
|
</p> |
10741 |
|
</blockquote><p> |
10742 |
|
|
10743 |
|
</p> |
10744 |
|
<a name="CREATE EFFECT_INSTANCE"></a><br /><hr /> |
10745 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10746 |
|
<a name="rfc.section.6.11.4"></a><h3>6.11.4. |
10747 |
|
Creating an instance of an effect by its portable ID</h3> |
10748 |
|
|
10749 |
|
<p>The front-end can spawn an instance of the desired |
10750 |
|
effect by sending the following command: |
10751 |
|
</p> |
10752 |
|
<p> |
10753 |
|
</p> |
10754 |
|
<blockquote class="text"> |
10755 |
|
<p>CREATE EFFECT_INSTANCE <effect-system> <module> <effect-name> |
10756 |
|
</p> |
10757 |
|
</blockquote><p> |
10758 |
|
|
10759 |
|
</p> |
10760 |
|
<p>Where <effect-system> is the "SYSTEM" field, |
10761 |
|
<module> the "MODULE" field and <effect-name> |
10762 |
|
the "NAME" field as returned by the |
10763 |
|
<a class='info' href='#GET EFFECT INFO'>"GET EFFECT INFO"<span> (</span><span class='info'>Retrieving general information about an effect</span><span>)</span></a> |
10764 |
|
command. The filename of argument <module> and the |
10765 |
|
character string of argument <effect-name> may contain |
10766 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>. |
10767 |
|
</p> |
10768 |
|
<p>The sampler will try to load the requested effect and to |
10769 |
|
create an instance of it. To allow loading the same effect |
10770 |
|
on a different machine, probably even running a completely |
10771 |
|
different operating system (e.g. Linux vs. Windows), the |
10772 |
|
sampler tries to match <module> "softly". That means |
10773 |
|
it first tries to find an effect that exactly matches the |
10774 |
|
given <module> argument. If there is no exact match, |
10775 |
|
the sampler will try to lower the restrictions on matching |
10776 |
|
the <module> argument more and more, e.g. by ignoring |
10777 |
|
upper / lower case differences and by ignoring the path of |
10778 |
|
the DLL filename and file extension. If there is still no |
10779 |
|
match at the end, the sampler will try to ignore the |
10780 |
|
<module> argument completely and as a last resort |
10781 |
|
search for an effect that only matches the given |
10782 |
|
<effect-system> and <effect-name> arguments. |
10783 |
|
</p> |
10784 |
|
<p>Possible Answers: |
10785 |
|
</p> |
10786 |
|
<p> |
10787 |
|
</p> |
10788 |
|
<blockquote class="text"> |
10789 |
|
<p>"OK[<effect-instance>]" - |
10790 |
|
</p> |
10791 |
|
<blockquote class="text"> |
10792 |
|
<p>in case the effect instance was |
10793 |
|
successfully created, where |
10794 |
|
<effect-instance> is the numerical ID |
10795 |
|
of the new effect instance |
10796 |
|
</p> |
10797 |
|
</blockquote> |
10798 |
|
|
10799 |
|
|
10800 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
10801 |
|
</p> |
10802 |
|
<blockquote class="text"> |
10803 |
|
<p>in case the effect instance was spawned |
10804 |
|
successfully, but there are noteworthy |
10805 |
|
issue(s) related, providing an appropriate |
10806 |
|
warning code and warning message |
10807 |
|
</p> |
10808 |
|
</blockquote> |
10809 |
|
|
10810 |
|
|
10811 |
|
<p>"ERR:<error-code>:<error-message>" - |
10812 |
|
</p> |
10813 |
|
<blockquote class="text"> |
10814 |
|
<p>if the effect could not be instantiated |
10815 |
|
</p> |
10816 |
|
</blockquote> |
10817 |
|
|
10818 |
|
|
10819 |
|
</blockquote><p> |
10820 |
|
|
10821 |
|
</p> |
10822 |
|
<p>Examples: |
10823 |
|
</p> |
10824 |
|
<p> |
10825 |
|
</p> |
10826 |
|
<blockquote class="text"> |
10827 |
|
<p>C: "CREATE EFFECT_INSTANCE LADSPA '/usr/lib/ladspa/mod_delay_1419.so' 'modDelay'" |
10828 |
|
</p> |
10829 |
|
<p>S: "OK[0]" |
10830 |
|
</p> |
10831 |
|
</blockquote><p> |
10832 |
|
|
10833 |
|
</p> |
10834 |
|
<a name="CREATE EFFECT_INSTANCE (non-portable)"></a><br /><hr /> |
10835 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10836 |
|
<a name="rfc.section.6.11.5"></a><h3>6.11.5. |
10837 |
|
Creating an instance of an effect by its numerical ID</h3> |
10838 |
|
|
10839 |
|
<p>The front-end can spawn an instance of the desired |
10840 |
|
effect by sending the following command: |
10841 |
|
</p> |
10842 |
|
<p> |
10843 |
|
</p> |
10844 |
|
<blockquote class="text"> |
10845 |
|
<p>CREATE EFFECT_INSTANCE <effect-index> |
10846 |
|
</p> |
10847 |
|
</blockquote><p> |
10848 |
|
|
10849 |
|
</p> |
10850 |
|
<p>Where <effect-index> is the numerical ID of the |
10851 |
|
effect as returned by the |
10852 |
|
<a class='info' href='#LIST AVAILABLE_EFFECTS'>"LIST AVAILABLE_EFFECTS"<span> (</span><span class='info'>Get list of available effects</span><span>)</span></a> |
10853 |
|
command. |
10854 |
|
</p> |
10855 |
|
<p>The sampler will try to load the requested effect and to |
10856 |
|
create an instance of it. |
10857 |
|
</p> |
10858 |
|
<p>Note: Since the numerical ID of a certain effect can |
10859 |
|
change at any time, you should not use this command in |
10860 |
|
LSCP files to restore a certain effect at a later time! To |
10861 |
|
store a sampler session including all its effects, use the |
10862 |
|
<a class='info' href='#CREATE EFFECT_INSTANCE'>portable text-based |
10863 |
|
version of "CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> instead! This |
10864 |
|
allows to restore a sampler session with all its effects |
10865 |
|
also on other machines, possibly even running a completely |
10866 |
|
different operating system (e.g. Linux vs. Windows), with |
10867 |
|
different plugin directories or plugin DLL names. |
10868 |
|
</p> |
10869 |
|
<p>Possible Answers: |
10870 |
|
</p> |
10871 |
|
<p> |
10872 |
|
</p> |
10873 |
|
<blockquote class="text"> |
10874 |
|
<p>"OK[<effect-instance>]" - |
10875 |
|
</p> |
10876 |
|
<blockquote class="text"> |
10877 |
|
<p>in case the effect instance was |
10878 |
|
successfully created, where |
10879 |
|
<effect-instance> is the numerical ID |
10880 |
|
of the new effect instance |
10881 |
|
</p> |
10882 |
|
</blockquote> |
10883 |
|
|
10884 |
|
|
10885 |
|
<p>"WRN:<warning-code>:<warning-message>" - |
10886 |
|
</p> |
10887 |
|
<blockquote class="text"> |
10888 |
|
<p>in case the effect instance was spawned |
10889 |
|
successfully, but there are noteworthy |
10890 |
|
issue(s) related, providing an appropriate |
10891 |
|
warning code and warning message |
10892 |
|
</p> |
10893 |
|
</blockquote> |
10894 |
|
|
10895 |
|
|
10896 |
|
<p>"ERR:<error-code>:<error-message>" - |
10897 |
|
</p> |
10898 |
|
<blockquote class="text"> |
10899 |
|
<p>if the effect could not be instantiated |
10900 |
|
</p> |
10901 |
|
</blockquote> |
10902 |
|
|
10903 |
|
|
10904 |
|
</blockquote><p> |
10905 |
|
|
10906 |
|
</p> |
10907 |
|
<p>Examples: |
10908 |
|
</p> |
10909 |
|
<p> |
10910 |
|
</p> |
10911 |
|
<blockquote class="text"> |
10912 |
|
<p>C: "CREATE EFFECT_INSTANCE 72" |
10913 |
|
</p> |
10914 |
|
<p>S: "OK[5]" |
10915 |
|
</p> |
10916 |
|
</blockquote><p> |
10917 |
|
|
10918 |
|
</p> |
10919 |
|
<a name="DESTROY EFFECT_INSTANCE"></a><br /><hr /> |
10920 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10921 |
|
<a name="rfc.section.6.11.6"></a><h3>6.11.6. |
10922 |
|
Destroy an effect instance</h3> |
10923 |
|
|
10924 |
|
<p>The front-end can destroy an unusued effect instance and |
10925 |
|
thus freeing it from memory by sending the following command: |
10926 |
|
</p> |
10927 |
|
<p> |
10928 |
|
</p> |
10929 |
|
<blockquote class="text"> |
10930 |
|
<p>DESTROY EFFECT_INSTANCE <effect-instance> |
10931 |
|
</p> |
10932 |
|
</blockquote><p> |
10933 |
|
|
10934 |
|
</p> |
10935 |
|
<p>Where <effect-instance> is the numerical ID of the |
10936 |
|
effect instance as returned by the |
10937 |
|
<a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> or |
10938 |
|
<a class='info' href='#LIST EFFECT_INSTANCES'>"LIST EFFECT_INSTANCES"<span> (</span><span class='info'>Get list of effect instances</span><span>)</span></a> |
10939 |
|
command. |
10940 |
|
</p> |
10941 |
|
<p>The effect instance can only be destroyed if it's not |
10942 |
|
used in any part of the sampler's audio signal path anymore. |
10943 |
|
If the effect instance is still in use somewhere, trying to |
10944 |
|
destroy the effect instance will result in an error |
10945 |
|
message. |
10946 |
|
</p> |
10947 |
|
<p>Possible Answers: |
10948 |
|
</p> |
10949 |
|
<p> |
10950 |
|
</p> |
10951 |
|
<blockquote class="text"> |
10952 |
|
<p>"OK" - |
10953 |
|
</p> |
10954 |
|
<blockquote class="text"> |
10955 |
|
<p>in case the effect instance was successfully destroyed |
10956 |
|
</p> |
10957 |
|
</blockquote> |
10958 |
|
|
10959 |
|
|
10960 |
|
<p>"ERR:<error-code>:<error-message>" - |
10961 |
|
</p> |
10962 |
|
<blockquote class="text"> |
10963 |
|
<p>in case it failed, providing an appropriate error code and |
10964 |
|
error message |
10965 |
|
</p> |
10966 |
|
</blockquote> |
10967 |
|
|
10968 |
|
|
10969 |
|
</blockquote><p> |
10970 |
|
|
10971 |
|
</p> |
10972 |
|
<p>Examples: |
10973 |
|
</p> |
10974 |
|
<p> |
10975 |
|
</p> |
10976 |
|
<blockquote class="text"> |
10977 |
|
<p>C: "DESTROY EFFECT_INSTANCE 5" |
10978 |
|
</p> |
10979 |
|
<p>S: "OK" |
10980 |
|
</p> |
10981 |
|
</blockquote><p> |
10982 |
|
|
10983 |
|
</p> |
10984 |
|
<a name="GET EFFECT_INSTANCES"></a><br /><hr /> |
10985 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
10986 |
|
<a name="rfc.section.6.11.7"></a><h3>6.11.7. |
10987 |
|
Retrieve amount of effect instances</h3> |
10988 |
|
|
10989 |
|
<p>The front-end can retrieve the current amount of effect |
10990 |
|
instances by sending the following command: |
10991 |
|
</p> |
10992 |
|
<p> |
10993 |
|
</p> |
10994 |
|
<blockquote class="text"> |
10995 |
|
<p>GET EFFECT_INSTANCES |
10996 |
|
</p> |
10997 |
|
</blockquote><p> |
10998 |
|
|
10999 |
|
</p> |
11000 |
|
<p>Possible Answers: |
11001 |
|
</p> |
11002 |
|
<p> |
11003 |
|
</p> |
11004 |
|
<blockquote class="text"> |
11005 |
|
<p>The sampler will answer by returning the current |
11006 |
|
number of effect instances created and not yet |
11007 |
|
destroyed in the current sampler session. |
11008 |
|
</p> |
11009 |
|
</blockquote><p> |
11010 |
|
|
11011 |
|
</p> |
11012 |
|
<p>Examples: |
11013 |
|
</p> |
11014 |
|
<p> |
11015 |
|
</p> |
11016 |
|
<blockquote class="text"> |
11017 |
|
<p>C: "GET EFFECT_INSTANCES" |
11018 |
|
</p> |
11019 |
|
<p>S: "14" |
11020 |
|
</p> |
11021 |
|
</blockquote><p> |
11022 |
|
|
11023 |
|
</p> |
11024 |
|
<a name="LIST EFFECT_INSTANCES"></a><br /><hr /> |
11025 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11026 |
|
<a name="rfc.section.6.11.8"></a><h3>6.11.8. |
11027 |
|
Get list of effect instances</h3> |
11028 |
|
|
11029 |
|
<p>The front-end can retrieve the current list of effect |
11030 |
|
instances by sending the following command: |
11031 |
|
</p> |
11032 |
|
<p> |
11033 |
|
</p> |
11034 |
|
<blockquote class="text"> |
11035 |
|
<p>LIST EFFECT_INSTANCES |
11036 |
|
</p> |
11037 |
|
</blockquote><p> |
11038 |
|
|
11039 |
|
</p> |
11040 |
|
<p>Possible Answers: |
11041 |
|
</p> |
11042 |
|
<p> |
11043 |
|
</p> |
11044 |
|
<blockquote class="text"> |
11045 |
|
<p>The sampler will answer by returning a comma |
11046 |
|
separated list with numerical IDs of effects |
11047 |
|
instances. |
11048 |
|
|
11049 |
|
</p> |
11050 |
|
</blockquote><p> |
11051 |
|
|
11052 |
|
</p> |
11053 |
|
<p>Example: |
11054 |
|
</p> |
11055 |
|
<p> |
11056 |
|
</p> |
11057 |
|
<blockquote class="text"> |
11058 |
|
<p>C: "LIST EFFECT_INSTANCES" |
11059 |
|
</p> |
11060 |
|
<p>S: "9,11,14,15,16,17,25" |
11061 |
|
</p> |
11062 |
|
</blockquote><p> |
11063 |
|
|
11064 |
|
</p> |
11065 |
|
<a name="GET EFFECT_INSTANCE INFO"></a><br /><hr /> |
11066 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11067 |
|
<a name="rfc.section.6.11.9"></a><h3>6.11.9. |
11068 |
|
Retrieving current information about an effect instance</h3> |
11069 |
|
|
11070 |
|
<p>The front-end can ask for the current informations about |
11071 |
|
a particular effect instance by sending the following command: |
11072 |
|
</p> |
11073 |
|
<p> |
11074 |
|
</p> |
11075 |
|
<blockquote class="text"> |
11076 |
|
<p>GET EFFECT_INSTANCE INFO <effect-instance> |
11077 |
|
</p> |
11078 |
|
</blockquote><p> |
11079 |
|
|
11080 |
|
</p> |
11081 |
|
<p>Where <effect-instance> is the numerical ID of an |
11082 |
|
effect instance as returned by the |
11083 |
|
<a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> |
11084 |
|
or |
11085 |
|
<a class='info' href='#LIST EFFECT_INSTANCES'>"LIST EFFECT_INSTANCES"<span> (</span><span class='info'>Get list of effect instances</span><span>)</span></a> |
11086 |
|
command. |
11087 |
|
</p> |
11088 |
|
<p>Possible Answers: |
11089 |
|
</p> |
11090 |
|
<p> |
11091 |
|
</p> |
11092 |
|
<blockquote class="text"> |
11093 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
11094 |
|
Each answer line begins with the information |
11095 |
|
category name, followed by a colon and then a space |
11096 |
|
character <SP> and finally the info character |
11097 |
|
string to that information category. At the |
11098 |
|
moment the following categories are defined: |
11099 |
|
</p> |
11100 |
|
<p> |
11101 |
|
</p> |
11102 |
|
<blockquote class="text"> |
11103 |
|
<p>SYSTEM - |
11104 |
|
</p> |
11105 |
|
<blockquote class="text"> |
11106 |
|
<p>name of the effect plugin system |
11107 |
|
the effect is based on |
11108 |
|
(e.g. "LADSPA") |
11109 |
|
</p> |
11110 |
|
</blockquote> |
11111 |
|
|
11112 |
|
|
11113 |
|
<p>MODULE - |
11114 |
|
</p> |
11115 |
|
<blockquote class="text"> |
11116 |
|
<p>module of the effect plugin |
11117 |
|
system that contains this effect, |
11118 |
|
the module is usually the |
11119 |
|
dynamic-linked library (DLL) |
11120 |
|
filename of the effect plugin, |
11121 |
|
including full path (note that this |
11122 |
|
filename may contain |
11123 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
11124 |
|
</p> |
11125 |
|
</blockquote> |
11126 |
|
|
11127 |
|
|
11128 |
|
<p>NAME - |
11129 |
|
</p> |
11130 |
|
<blockquote class="text"> |
11131 |
|
<p>character string defining the |
11132 |
|
unique name of the effect within its |
11133 |
|
module (note that the character |
11134 |
|
string may contain |
11135 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
11136 |
|
</p> |
11137 |
|
</blockquote> |
11138 |
|
|
11139 |
|
|
11140 |
|
<p>DESCRIPTION - |
11141 |
|
</p> |
11142 |
|
<blockquote class="text"> |
11143 |
|
<p>human readable name of the |
11144 |
|
effect, intended to be displayed in |
11145 |
|
user interfaces (note that the |
11146 |
|
character string may contain |
11147 |
|
<a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
11148 |
|
</p> |
11149 |
|
</blockquote> |
11150 |
|
|
11151 |
|
|
11152 |
|
<p>INPUT_CONTROLS - |
11153 |
|
</p> |
11154 |
|
<blockquote class="text"> |
11155 |
|
<p>amount of input controls the |
11156 |
|
effect instance provides, to allow |
11157 |
|
controlling the effect parameters in |
11158 |
|
realtime |
11159 |
|
</p> |
11160 |
|
</blockquote> |
11161 |
|
|
11162 |
|
|
11163 |
|
</blockquote> |
11164 |
|
|
11165 |
|
|
11166 |
|
</blockquote><p> |
11167 |
|
|
11168 |
|
</p> |
11169 |
|
<p>The mentioned fields above don't have to be in particular order. |
11170 |
|
</p> |
11171 |
|
<p>Example: |
11172 |
|
</p> |
11173 |
|
<p> |
11174 |
|
</p> |
11175 |
|
<blockquote class="text"> |
11176 |
|
<p>C: "GET EFFECT_INSTANCE INFO 3" |
11177 |
|
</p> |
11178 |
|
<p>S: "SYSTEM: LADSPA" |
11179 |
|
</p> |
11180 |
|
<p> "MODULE: /usr/lib/ladspa/mod_delay_1419.so" |
11181 |
|
</p> |
11182 |
|
<p> "NAME: modDelay" |
11183 |
|
</p> |
11184 |
|
<p> "DESCRIPTION: Modulatable delay" |
11185 |
|
</p> |
11186 |
|
<p> "INPUT_CONTROLS: 1" |
11187 |
|
</p> |
11188 |
|
<p> "." |
11189 |
|
</p> |
11190 |
|
</blockquote><p> |
11191 |
|
|
11192 |
|
</p> |
11193 |
|
<a name="GET EFFECT_INSTANCE_INPUT_CONTROL INFO"></a><br /><hr /> |
11194 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11195 |
|
<a name="rfc.section.6.11.10"></a><h3>6.11.10. |
11196 |
|
Retrieving information about an effect parameter</h3> |
11197 |
|
|
11198 |
|
<p>Effects typically provide a certain set of effect |
11199 |
|
parameters which can be altered by the user in realtime |
11200 |
|
(e.g. depth of a reverb effect, duration of a delay effect, |
11201 |
|
dry / wet signal ratio). Those controllable effect parameters |
11202 |
|
are called "input controls". The front-end can ask for the |
11203 |
|
current informations of an effect instance's input control |
11204 |
|
by sending the following command: |
11205 |
|
</p> |
11206 |
|
<p> |
11207 |
|
</p> |
11208 |
|
<blockquote class="text"> |
11209 |
|
<p>GET EFFECT_INSTANCE_INPUT_CONTROL INFO <effect-instance> <input-control> |
11210 |
|
</p> |
11211 |
|
</blockquote><p> |
11212 |
|
|
11213 |
|
</p> |
11214 |
|
<p>Where <effect-instance> is the numerical ID of an |
11215 |
|
effect instance as returned by the |
11216 |
|
<a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> |
11217 |
|
or |
11218 |
|
<a class='info' href='#LIST EFFECT_INSTANCES'>"LIST EFFECT_INSTANCES"<span> (</span><span class='info'>Get list of effect instances</span><span>)</span></a> |
11219 |
|
command and <input-control> is the index of the input |
11220 |
|
control within the numerical bounds as returned by the |
11221 |
|
"INPUT_CONTROLS" field of the |
11222 |
|
<a class='info' href='#GET EFFECT_INSTANCE INFO'>"GET EFFECT_INSTANCE INFO"<span> (</span><span class='info'>Retrieving current information about an effect instance</span><span>)</span></a> |
11223 |
|
command. |
11224 |
|
</p> |
11225 |
|
<p>Possible Answers: |
11226 |
|
</p> |
11227 |
|
<p> |
11228 |
|
</p> |
11229 |
|
<blockquote class="text"> |
11230 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
11231 |
|
Each answer line begins with the information |
11232 |
|
category name, followed by a colon and then a space |
11233 |
|
character <SP> and finally the info character |
11234 |
|
string to that information category. There are |
11235 |
|
information categories which are always returned, |
11236 |
|
independent of the respective effect parameter and |
11237 |
|
there are optional information categories |
11238 |
|
which are only shown for certain effect parameters. |
11239 |
|
At the moment the following categories are defined: |
11240 |
|
</p> |
11241 |
|
<p> |
11242 |
|
</p> |
11243 |
|
<blockquote class="text"> |
11244 |
|
<p>DESCRIPTION - |
11245 |
|
</p> |
11246 |
|
<blockquote class="text"> |
11247 |
|
<p>(always returned) |
11248 |
|
human readable name of the |
11249 |
|
effect parameter, intended to be |
11250 |
|
displayed in user interfaces (note |
11251 |
|
that the character string may |
11252 |
|
contain <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>) |
11253 |
|
</p> |
11254 |
|
</blockquote> |
11255 |
|
|
11256 |
|
|
11257 |
|
<p>VALUE - |
11258 |
|
</p> |
11259 |
|
<blockquote class="text"> |
11260 |
|
<p> |
11261 |
|
(always returned) |
11262 |
|
current (optional dotted) |
11263 |
|
floating point value of this effect |
11264 |
|
parameter |
11265 |
|
</p> |
11266 |
|
</blockquote> |
11267 |
|
|
11268 |
|
|
11269 |
|
<p>RANGE_MIN - |
11270 |
|
</p> |
11271 |
|
<blockquote class="text"> |
11272 |
|
<p> |
11273 |
|
(optionally returned) |
11274 |
|
minimum allowed value for this |
11275 |
|
effect parameter |
11276 |
|
</p> |
11277 |
|
</blockquote> |
11278 |
|
|
11279 |
|
|
11280 |
|
<p>RANGE_MAX - |
11281 |
|
</p> |
11282 |
|
<blockquote class="text"> |
11283 |
|
<p> |
11284 |
|
(optionally returned) |
11285 |
|
maximum allowed value for this |
11286 |
|
effect parameter |
11287 |
|
</p> |
11288 |
|
</blockquote> |
11289 |
|
|
11290 |
|
|
11291 |
|
<p>POSSIBILITIES - |
11292 |
|
</p> |
11293 |
|
<blockquote class="text"> |
11294 |
|
<p> |
11295 |
|
(optionally returned) |
11296 |
|
comma separated list of |
11297 |
|
(optional dotted) floating point |
11298 |
|
numbers, reflecting the exact set of |
11299 |
|
possible values for this effect |
11300 |
|
parameter |
11301 |
|
</p> |
11302 |
|
</blockquote> |
11303 |
|
|
11304 |
|
|
11305 |
|
<p>DEFAULT - |
11306 |
|
</p> |
11307 |
|
<blockquote class="text"> |
11308 |
|
<p> |
11309 |
|
(optionally returned) |
11310 |
|
default value of this effect |
11311 |
|
parameter |
11312 |
|
</p> |
11313 |
|
</blockquote> |
11314 |
|
|
11315 |
|
|
11316 |
|
</blockquote> |
11317 |
|
|
11318 |
|
|
11319 |
|
</blockquote><p> |
11320 |
|
|
11321 |
|
</p> |
11322 |
|
<p>The mentioned fields above don't have to be in particular order. |
11323 |
|
</p> |
11324 |
|
<p>Example: |
11325 |
|
</p> |
11326 |
|
<p> |
11327 |
|
</p> |
11328 |
|
<blockquote class="text"> |
11329 |
|
<p>C: "GET EFFECT_INSTANCE_INPUT_CONTROL INFO 1 0" |
11330 |
|
</p> |
11331 |
|
<p>S: "DESCRIPTION: Base delay (s)" |
11332 |
|
</p> |
11333 |
|
<p> "VALUE: 0.500" |
11334 |
|
</p> |
11335 |
|
<p> "RANGE_MIN: 0.000" |
11336 |
|
</p> |
11337 |
|
<p> "." |
11338 |
|
</p> |
11339 |
|
</blockquote><p> |
11340 |
|
|
11341 |
|
</p> |
11342 |
|
<a name="SET EFFECT_INSTANCE_INPUT_CONTROL VALUE"></a><br /><hr /> |
11343 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11344 |
|
<a name="rfc.section.6.11.11"></a><h3>6.11.11. |
11345 |
|
Altering an effect parameter</h3> |
11346 |
|
|
11347 |
|
<p>The front-end can alter the current value of an effect |
11348 |
|
parameter by sending the following command: |
11349 |
|
</p> |
11350 |
|
<p> |
11351 |
|
</p> |
11352 |
|
<blockquote class="text"> |
11353 |
|
<p>SET EFFECT_INSTANCE_INPUT_CONTROL VALUE <effect-instance> <input-control> <value> |
11354 |
|
</p> |
11355 |
|
</blockquote><p> |
11356 |
|
|
11357 |
|
</p> |
11358 |
|
<p>Where <effect-instance> is the numerical ID of the |
11359 |
|
effect instance as returned by the |
11360 |
|
<a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> or |
11361 |
|
<a class='info' href='#LIST EFFECT_INSTANCES'>"LIST EFFECT_INSTANCES"<span> (</span><span class='info'>Get list of effect instances</span><span>)</span></a> |
11362 |
|
command, <input-control> is the index of the input |
11363 |
|
control within the numerical bounds as returned by the |
11364 |
|
"INPUT_CONTROLS" field of the |
11365 |
|
<a class='info' href='#GET EFFECT_INSTANCE INFO'>"GET EFFECT_INSTANCE INFO"<span> (</span><span class='info'>Retrieving current information about an effect instance</span><span>)</span></a> |
11366 |
|
command and <value> is the new (optional dotted) |
11367 |
|
floating point value for this effect parameter. |
11368 |
|
</p> |
11369 |
|
<p>Possible Answers: |
11370 |
|
</p> |
11371 |
|
<p> |
11372 |
|
</p> |
11373 |
|
<blockquote class="text"> |
11374 |
|
<p>"OK" - |
11375 |
|
</p> |
11376 |
|
<blockquote class="text"> |
11377 |
|
<p>in case the effect was altered successfully |
11378 |
|
</p> |
11379 |
|
</blockquote> |
11380 |
|
|
11381 |
|
|
11382 |
|
<p>"ERR:<error-code>:<error-message>" - |
11383 |
|
</p> |
11384 |
|
<blockquote class="text"> |
11385 |
|
<p>in case it failed, providing an appropriate error code and |
11386 |
|
error message |
11387 |
|
</p> |
11388 |
|
</blockquote> |
11389 |
|
|
11390 |
|
|
11391 |
|
</blockquote><p> |
11392 |
|
|
11393 |
|
</p> |
11394 |
|
<p>Examples: |
11395 |
|
</p> |
11396 |
|
<p> |
11397 |
|
</p> |
11398 |
|
<blockquote class="text"> |
11399 |
|
<p>C: "SET EFFECT_INSTANCE_INPUT_CONTROL VALUE 0 1 0.5" |
11400 |
|
</p> |
11401 |
|
<p>S: "OK" |
11402 |
|
</p> |
11403 |
|
</blockquote><p> |
11404 |
|
|
11405 |
|
</p> |
11406 |
|
<a name="GET SEND_EFFECT_CHAINS"></a><br /><hr /> |
11407 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11408 |
|
<a name="rfc.section.6.11.12"></a><h3>6.11.12. |
11409 |
|
Retrieve amount of send effect chains</h3> |
11410 |
|
|
11411 |
|
<p>The front-end can retrieve the current amount of send |
11412 |
|
effect chains of an audio output device by sending the |
11413 |
|
following command: |
11414 |
|
</p> |
11415 |
|
<p> |
11416 |
|
</p> |
11417 |
|
<blockquote class="text"> |
11418 |
|
<p>GET SEND_EFFECT_CHAINS <audio-device> |
11419 |
|
</p> |
11420 |
|
</blockquote><p> |
11421 |
|
|
11422 |
|
</p> |
11423 |
|
<p>Where <audio-device> should be replaced by the |
11424 |
|
numerical ID of the audio output device as given by the |
11425 |
|
<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> |
11426 |
|
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> |
11427 |
|
command. |
11428 |
|
</p> |
11429 |
|
<p>Possible Answers: |
11430 |
|
</p> |
11431 |
|
<p> |
11432 |
|
</p> |
11433 |
|
<blockquote class="text"> |
11434 |
|
<p>The sampler will answer by returning the current |
11435 |
|
number of send effect chains of the supplied audio |
11436 |
|
output device. |
11437 |
|
</p> |
11438 |
|
</blockquote><p> |
11439 |
|
|
11440 |
|
</p> |
11441 |
|
<p>Examples: |
11442 |
|
</p> |
11443 |
|
<p> |
11444 |
|
</p> |
11445 |
|
<blockquote class="text"> |
11446 |
|
<p>C: "GET SEND_EFFECT_CHAINS 0" |
11447 |
|
</p> |
11448 |
|
<p>S: "4" |
11449 |
|
</p> |
11450 |
|
</blockquote><p> |
11451 |
|
|
11452 |
|
</p> |
11453 |
|
<a name="LIST SEND_EFFECT_CHAINS"></a><br /><hr /> |
11454 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11455 |
|
<a name="rfc.section.6.11.13"></a><h3>6.11.13. |
11456 |
|
Retrieve list of send effect chains</h3> |
11457 |
|
|
11458 |
|
<p>The front-end can retrieve the current list of send |
11459 |
|
effect chains of an audio output device by sending the |
11460 |
|
following command: |
11461 |
|
</p> |
11462 |
|
<p> |
11463 |
|
</p> |
11464 |
|
<blockquote class="text"> |
11465 |
|
<p>LIST SEND_EFFECT_CHAINS <audio-device> |
11466 |
|
</p> |
11467 |
|
</blockquote><p> |
11468 |
|
|
11469 |
|
</p> |
11470 |
|
<p>Where <audio-device> should be replaced by the |
11471 |
|
numerical ID of the audio output device as given by the |
11472 |
|
<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> |
11473 |
|
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> |
11474 |
|
command. |
11475 |
|
</p> |
11476 |
|
<p>Possible Answers: |
11477 |
|
</p> |
11478 |
|
<p> |
11479 |
|
</p> |
11480 |
|
<blockquote class="text"> |
11481 |
|
<p>The sampler will answer by returning a comma |
11482 |
|
separated list with numerical IDs of send effect |
11483 |
|
chains of the supplied audio output device. |
11484 |
|
|
11485 |
|
</p> |
11486 |
|
</blockquote><p> |
11487 |
|
|
11488 |
|
</p> |
11489 |
|
<p>Examples: |
11490 |
|
</p> |
11491 |
|
<p> |
11492 |
|
</p> |
11493 |
|
<blockquote class="text"> |
11494 |
|
<p>C: "LIST SEND_EFFECT_CHAINS 0" |
11495 |
|
</p> |
11496 |
|
<p>S: "3,4,7" |
11497 |
|
</p> |
11498 |
|
</blockquote><p> |
11499 |
|
|
11500 |
|
</p> |
11501 |
|
<a name="ADD SEND_EFFECT_CHAIN"></a><br /><hr /> |
11502 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11503 |
|
<a name="rfc.section.6.11.14"></a><h3>6.11.14. |
11504 |
|
Add send effect chain</h3> |
11505 |
|
|
11506 |
|
<p>The front-end can add a send effect chain by sending the |
11507 |
|
following command: |
11508 |
|
</p> |
11509 |
|
<p> |
11510 |
|
</p> |
11511 |
|
<blockquote class="text"> |
11512 |
|
<p>ADD SEND_EFFECT_CHAIN <audio-device> |
11513 |
|
</p> |
11514 |
|
</blockquote><p> |
11515 |
|
|
11516 |
|
</p> |
11517 |
|
<p>Where <audio-device> should be replaced by the |
11518 |
|
numerical ID of the audio output device as given by the |
11519 |
|
<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> |
11520 |
|
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> |
11521 |
|
command. |
11522 |
|
</p> |
11523 |
|
<p>Possible Answers: |
11524 |
|
</p> |
11525 |
|
<p> |
11526 |
|
</p> |
11527 |
|
<blockquote class="text"> |
11528 |
|
<p>"OK[<effect-chain>]" - |
11529 |
|
</p> |
11530 |
|
<blockquote class="text"> |
11531 |
|
<p>in case the send effect chain was |
11532 |
|
added successfully, where |
11533 |
|
<effect-chain> is the numerical ID |
11534 |
|
of the new send effect chain |
11535 |
|
</p> |
11536 |
|
</blockquote> |
11537 |
|
|
11538 |
|
|
11539 |
|
<p>"ERR:<error-code>:<error-message>" - |
11540 |
|
</p> |
11541 |
|
<blockquote class="text"> |
11542 |
|
<p>if the send effect chain could not be added |
11543 |
|
</p> |
11544 |
|
</blockquote> |
11545 |
|
|
11546 |
|
|
11547 |
|
</blockquote><p> |
11548 |
|
|
11549 |
|
</p> |
11550 |
|
<p>Examples: |
11551 |
|
</p> |
11552 |
|
<p> |
11553 |
|
</p> |
11554 |
|
<blockquote class="text"> |
11555 |
|
<p>C: "ADD SEND_EFFECT_CHAIN 0" |
11556 |
|
</p> |
11557 |
|
<p>S: "OK[2]" |
11558 |
|
</p> |
11559 |
|
</blockquote><p> |
11560 |
|
|
11561 |
|
</p> |
11562 |
|
<a name="REMOVE SEND_EFFECT_CHAIN"></a><br /><hr /> |
11563 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11564 |
|
<a name="rfc.section.6.11.15"></a><h3>6.11.15. |
11565 |
|
Remove send effect chain</h3> |
11566 |
|
|
11567 |
|
<p>The front-end can remove a send effect chain by sending |
11568 |
|
the following command: |
11569 |
|
</p> |
11570 |
|
<p> |
11571 |
|
</p> |
11572 |
|
<blockquote class="text"> |
11573 |
|
<p>REMOVE SEND_EFFECT_CHAIN <audio-device> <effect-chain> |
11574 |
|
</p> |
11575 |
|
</blockquote><p> |
11576 |
|
|
11577 |
|
</p> |
11578 |
|
<p>Where <audio-device> should be replaced by the |
11579 |
|
numerical ID of the audio output device as given by the |
11580 |
|
<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> |
11581 |
|
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> |
11582 |
|
command and <effect-chain> by the numerical ID as |
11583 |
|
returned by the |
11584 |
|
<a class='info' href='#ADD SEND_EFFECT_CHAIN'>"ADD SEND_EFFECT_CHAIN"<span> (</span><span class='info'>Add send effect chain</span><span>)</span></a> |
11585 |
|
or |
11586 |
|
<a class='info' href='#LIST SEND_EFFECT_CHAINS'>"LIST SEND_EFFECT_CHAINS"<span> (</span><span class='info'>Retrieve list of send effect chains</span><span>)</span></a> |
11587 |
|
command. |
11588 |
|
</p> |
11589 |
|
<p>Possible Answers: |
11590 |
|
</p> |
11591 |
|
<p> |
11592 |
|
</p> |
11593 |
|
<blockquote class="text"> |
11594 |
|
<p>"OK" - |
11595 |
|
</p> |
11596 |
|
<blockquote class="text"> |
11597 |
|
<p>in case the send effect chain was |
11598 |
|
removed successfully |
11599 |
|
</p> |
11600 |
|
</blockquote> |
11601 |
|
|
11602 |
|
|
11603 |
|
<p>"ERR:<error-code>:<error-message>" - |
11604 |
|
</p> |
11605 |
|
<blockquote class="text"> |
11606 |
|
<p>if the send effect chain could not be removed |
11607 |
|
</p> |
11608 |
|
</blockquote> |
11609 |
|
|
11610 |
|
|
11611 |
|
</blockquote><p> |
11612 |
|
|
11613 |
|
</p> |
11614 |
|
<p>Examples: |
11615 |
|
</p> |
11616 |
|
<p> |
11617 |
|
</p> |
11618 |
|
<blockquote class="text"> |
11619 |
|
<p>C: "REMOVE SEND_EFFECT_CHAIN 0 2" |
11620 |
|
</p> |
11621 |
|
<p>S: "OK" |
11622 |
|
</p> |
11623 |
|
</blockquote><p> |
11624 |
|
|
11625 |
|
</p> |
11626 |
|
<a name="GET SEND_EFFECT_CHAIN INFO"></a><br /><hr /> |
11627 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11628 |
|
<a name="rfc.section.6.11.16"></a><h3>6.11.16. |
11629 |
|
Retrieving information about a send effect chain</h3> |
11630 |
|
|
11631 |
|
<p>The front-end can ask for informations of a send effect |
11632 |
|
chain by sending the following command: |
11633 |
|
</p> |
11634 |
|
<p> |
11635 |
|
</p> |
11636 |
|
<blockquote class="text"> |
11637 |
|
<p>GET SEND_EFFECT_CHAIN INFO <audio-device> <effect-chain> |
11638 |
|
</p> |
11639 |
|
</blockquote><p> |
11640 |
|
|
11641 |
|
</p> |
11642 |
|
<p>Where <audio-device> should be replaced by the |
11643 |
|
numerical ID of the audio output device as given by the |
11644 |
|
<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> |
11645 |
|
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> |
11646 |
|
command and <effect-chain> by the numerical ID as |
11647 |
|
returned by the |
11648 |
|
<a class='info' href='#ADD SEND_EFFECT_CHAIN'>"ADD SEND_EFFECT_CHAIN"<span> (</span><span class='info'>Add send effect chain</span><span>)</span></a> |
11649 |
|
or |
11650 |
|
<a class='info' href='#LIST SEND_EFFECT_CHAINS'>"LIST SEND_EFFECT_CHAINS"<span> (</span><span class='info'>Retrieve list of send effect chains</span><span>)</span></a> |
11651 |
|
command. |
11652 |
|
</p> |
11653 |
|
<p>Possible Answers: |
11654 |
|
</p> |
11655 |
|
<p> |
11656 |
|
</p> |
11657 |
|
<blockquote class="text"> |
11658 |
|
<p>LinuxSampler will answer by sending a <CRLF> separated list. |
11659 |
|
Each answer line begins with the information |
11660 |
|
category name, followed by a colon and then a space |
11661 |
|
character <SP> and finally the info character |
11662 |
|
string to that information category. |
11663 |
|
At the moment the following categories are defined: |
11664 |
|
</p> |
11665 |
|
<p> |
11666 |
|
</p> |
11667 |
|
<blockquote class="text"> |
11668 |
|
<p>EFFECT_COUNT - |
11669 |
|
</p> |
11670 |
|
<blockquote class="text"> |
11671 |
|
<p>amount of effects in this send |
11672 |
|
effect chain |
11673 |
|
</p> |
11674 |
|
</blockquote> |
11675 |
|
|
11676 |
|
|
11677 |
|
<p>EFFECT_SEQUENCE - |
11678 |
|
</p> |
11679 |
|
<blockquote class="text"> |
11680 |
|
<p>comma separated list of the |
11681 |
|
numerical IDs of the effect |
11682 |
|
instances in this send effect chain, |
11683 |
|
in the order as they are procssed in |
11684 |
|
the effect chain |
11685 |
|
</p> |
11686 |
|
</blockquote> |
11687 |
|
|
11688 |
|
|
11689 |
|
</blockquote> |
11690 |
|
|
11691 |
|
|
11692 |
|
</blockquote><p> |
11693 |
|
|
11694 |
|
</p> |
11695 |
|
<p>The mentioned fields above don't have to be in particular order. |
11696 |
|
</p> |
11697 |
|
<p>Example: |
11698 |
|
</p> |
11699 |
|
<p> |
11700 |
|
</p> |
11701 |
|
<blockquote class="text"> |
11702 |
|
<p>C: "GET SEND_EFFECT_CHAIN INFO 0 2" |
11703 |
|
</p> |
11704 |
|
<p>S: "EFFECT_COUNT: 3" |
11705 |
|
</p> |
11706 |
|
<p> "EFFECT_SEQUENCE: 31,4,7" |
11707 |
|
</p> |
11708 |
|
<p> "." |
11709 |
|
</p> |
11710 |
|
</blockquote><p> |
11711 |
|
|
11712 |
|
</p> |
11713 |
|
<a name="APPEND SEND_EFFECT_CHAIN EFFECT"></a><br /><hr /> |
11714 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11715 |
|
<a name="rfc.section.6.11.17"></a><h3>6.11.17. |
11716 |
|
Append effect instance to a send effect chain</h3> |
11717 |
|
|
11718 |
|
<p>The front-end can add an unused effect instance to the |
11719 |
|
end of a send effect chain by sending the following command: |
11720 |
|
</p> |
11721 |
|
<p> |
11722 |
|
</p> |
11723 |
|
<blockquote class="text"> |
11724 |
|
<p>APPEND SEND_EFFECT_CHAIN EFFECT <audio-device> <effect-chain> <effect-instance> |
11725 |
|
</p> |
11726 |
|
</blockquote><p> |
11727 |
|
|
11728 |
|
</p> |
11729 |
|
<p>Where <audio-device> should be replaced by the |
11730 |
|
numerical ID of the audio output device as given by the |
11731 |
|
<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> |
11732 |
|
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> |
11733 |
|
command and <effect-chain> by the numerical ID as |
11734 |
|
returned by the |
11735 |
|
<a class='info' href='#ADD SEND_EFFECT_CHAIN'>"ADD SEND_EFFECT_CHAIN"<span> (</span><span class='info'>Add send effect chain</span><span>)</span></a> |
11736 |
|
or |
11737 |
|
<a class='info' href='#LIST SEND_EFFECT_CHAINS'>"LIST SEND_EFFECT_CHAINS"<span> (</span><span class='info'>Retrieve list of send effect chains</span><span>)</span></a> |
11738 |
|
command and <effect-instance> as returned by the |
11739 |
|
<a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> or |
11740 |
|
<a class='info' href='#LIST EFFECT_INSTANCES'>"LIST EFFECT_INSTANCES"<span> (</span><span class='info'>Get list of effect instances</span><span>)</span></a> |
11741 |
|
command. |
11742 |
|
</p> |
11743 |
|
<p>Only unused effect instances can be added to the effect |
11744 |
|
chain. Trying to add an effect instance which is already in |
11745 |
|
use somewhere in the audio signal path of the sampler will |
11746 |
|
result in an error. |
11747 |
|
</p> |
11748 |
|
<p>Possible Answers: |
11749 |
|
</p> |
11750 |
|
<p> |
11751 |
|
</p> |
11752 |
|
<blockquote class="text"> |
11753 |
|
<p>"OK" - |
11754 |
|
</p> |
11755 |
|
<blockquote class="text"> |
11756 |
|
<p>in case the effect instance was |
11757 |
|
added successfully to the chain |
11758 |
|
</p> |
11759 |
|
</blockquote> |
11760 |
|
|
11761 |
|
|
11762 |
|
<p>"ERR:<error-code>:<error-message>" - |
11763 |
|
</p> |
11764 |
|
<blockquote class="text"> |
11765 |
|
<p>if the effect instance could not be added |
11766 |
|
</p> |
11767 |
|
</blockquote> |
11768 |
|
|
11769 |
|
|
11770 |
|
</blockquote><p> |
11771 |
|
|
11772 |
|
</p> |
11773 |
|
<p>Examples: |
11774 |
|
</p> |
11775 |
|
<p> |
11776 |
|
</p> |
11777 |
|
<blockquote class="text"> |
11778 |
|
<p>C: "APPEND SEND_EFFECT_CHAIN EFFECT 0 2 38" |
11779 |
|
</p> |
11780 |
|
<p>S: "OK" |
11781 |
|
</p> |
11782 |
|
</blockquote><p> |
11783 |
|
|
11784 |
|
</p> |
11785 |
|
<a name="INSERT SEND_EFFECT_CHAIN EFFECT"></a><br /><hr /> |
11786 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11787 |
|
<a name="rfc.section.6.11.18"></a><h3>6.11.18. |
11788 |
|
Insert effect instance to a send effect chain</h3> |
11789 |
|
|
11790 |
|
<p>The front-end can add an unused effect instance to a |
11791 |
|
certain position of a send effect chain by sending the |
11792 |
|
following command: |
11793 |
|
</p> |
11794 |
|
<p> |
11795 |
|
</p> |
11796 |
|
<blockquote class="text"> |
11797 |
|
<p>INSERT SEND_EFFECT_CHAIN EFFECT <audio-device> <effect-chain> <chain-pos> <effect-instance> |
11798 |
|
</p> |
11799 |
|
</blockquote><p> |
11800 |
|
|
11801 |
|
</p> |
11802 |
|
<p>Where <audio-device> should be replaced by the |
11803 |
|
numerical ID of the audio output device as given by the |
11804 |
|
<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> |
11805 |
|
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> |
11806 |
|
command, <effect-chain> by the numerical ID as |
11807 |
|
returned by the |
11808 |
|
<a class='info' href='#ADD SEND_EFFECT_CHAIN'>"ADD SEND_EFFECT_CHAIN"<span> (</span><span class='info'>Add send effect chain</span><span>)</span></a> |
11809 |
|
or |
11810 |
|
<a class='info' href='#LIST SEND_EFFECT_CHAINS'>"LIST SEND_EFFECT_CHAINS"<span> (</span><span class='info'>Retrieve list of send effect chains</span><span>)</span></a> |
11811 |
|
command, <effect-instance> as returned by the |
11812 |
|
<a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> or |
11813 |
|
<a class='info' href='#LIST EFFECT_INSTANCES'>"LIST EFFECT_INSTANCES"<span> (</span><span class='info'>Get list of effect instances</span><span>)</span></a> |
11814 |
|
command and <chain-pos> the exact position of the |
11815 |
|
effect chain where the supplied effect shall be inserted |
11816 |
|
to. |
11817 |
|
</p> |
11818 |
|
<p>Only unused effect instances can be added to the effect |
11819 |
|
chain. Trying to add an effect instance which is already in |
11820 |
|
use somewhere in the audio signal path of the sampler will |
11821 |
|
result in an error. |
11822 |
|
</p> |
11823 |
|
<p>Possible Answers: |
11824 |
|
</p> |
11825 |
|
<p> |
11826 |
|
</p> |
11827 |
|
<blockquote class="text"> |
11828 |
|
<p>"OK" - |
11829 |
|
</p> |
11830 |
|
<blockquote class="text"> |
11831 |
|
<p>in case the effect instance was |
11832 |
|
added successfully to the chain |
11833 |
|
</p> |
11834 |
|
</blockquote> |
11835 |
|
|
11836 |
|
|
11837 |
|
<p>"ERR:<error-code>:<error-message>" - |
11838 |
|
</p> |
11839 |
|
<blockquote class="text"> |
11840 |
|
<p>if the effect instance could not be added |
11841 |
|
</p> |
11842 |
|
</blockquote> |
11843 |
|
|
11844 |
|
|
11845 |
|
</blockquote><p> |
11846 |
|
|
11847 |
|
</p> |
11848 |
|
<p>Examples: |
11849 |
|
</p> |
11850 |
|
<p> |
11851 |
|
</p> |
11852 |
|
<blockquote class="text"> |
11853 |
|
<p>C: "INSERT SEND_EFFECT_CHAIN EFFECT 0 2 4 38" |
11854 |
|
</p> |
11855 |
|
<p>S: "OK" |
11856 |
|
</p> |
11857 |
|
</blockquote><p> |
11858 |
|
|
11859 |
|
</p> |
11860 |
|
<a name="REMOVE SEND_EFFECT_CHAIN EFFECT"></a><br /><hr /> |
11861 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11862 |
|
<a name="rfc.section.6.11.19"></a><h3>6.11.19. |
11863 |
|
Remove effect instance from send effect chain</h3> |
11864 |
|
|
11865 |
|
<p>The front-end can remove an effect instance from a |
11866 |
|
certain position of a send effect chain by sending the |
11867 |
|
following command: |
11868 |
|
</p> |
11869 |
|
<p> |
11870 |
|
</p> |
11871 |
|
<blockquote class="text"> |
11872 |
|
<p>REMOVE SEND_EFFECT_CHAIN EFFECT <audio-device> <effect-chain> <chain-pos> |
11873 |
|
</p> |
11874 |
|
</blockquote><p> |
11875 |
|
|
11876 |
|
</p> |
11877 |
|
<p>Where <audio-device> should be replaced by the |
11878 |
|
numerical ID of the audio output device as given by the |
11879 |
|
<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> |
11880 |
|
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> |
11881 |
|
command, <effect-chain> by the numerical ID as |
11882 |
|
returned by the |
11883 |
|
<a class='info' href='#ADD SEND_EFFECT_CHAIN'>"ADD SEND_EFFECT_CHAIN"<span> (</span><span class='info'>Add send effect chain</span><span>)</span></a> |
11884 |
|
or |
11885 |
|
<a class='info' href='#LIST SEND_EFFECT_CHAINS'>"LIST SEND_EFFECT_CHAINS"<span> (</span><span class='info'>Retrieve list of send effect chains</span><span>)</span></a> |
11886 |
|
command and <chain-pos> the exact position of the |
11887 |
|
effect instance to be removed from the effect chain. |
11888 |
|
</p> |
11889 |
|
<p>Possible Answers: |
11890 |
|
</p> |
11891 |
|
<p> |
11892 |
|
</p> |
11893 |
|
<blockquote class="text"> |
11894 |
|
<p>"OK" - |
11895 |
|
</p> |
11896 |
|
<blockquote class="text"> |
11897 |
|
<p>in case the effect instance was |
11898 |
|
removed successfully |
11899 |
|
</p> |
11900 |
|
</blockquote> |
11901 |
|
|
11902 |
|
|
11903 |
|
<p>"ERR:<error-code>:<error-message>" - |
11904 |
|
</p> |
11905 |
|
<blockquote class="text"> |
11906 |
|
<p>if the effect instance could not be removed |
11907 |
|
</p> |
11908 |
|
</blockquote> |
11909 |
|
|
11910 |
|
|
11911 |
|
</blockquote><p> |
11912 |
|
|
11913 |
|
</p> |
11914 |
|
<p>Examples: |
11915 |
|
</p> |
11916 |
|
<p> |
11917 |
|
</p> |
11918 |
|
<blockquote class="text"> |
11919 |
|
<p>C: "REMOVE SEND_EFFECT_CHAIN EFFECT 0 2 4" |
11920 |
|
</p> |
11921 |
|
<p>S: "OK" |
11922 |
|
</p> |
11923 |
|
</blockquote><p> |
11924 |
|
|
11925 |
|
</p> |
11926 |
<a name="command_syntax"></a><br /><hr /> |
<a name="command_syntax"></a><br /><hr /> |
11927 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
11928 |
<a name="rfc.section.7"></a><h3>7. |
<a name="rfc.section.7"></a><h3>7. |
12023 |
<p>/ UNSUBSCRIBE SP unsubscribe_event |
<p>/ UNSUBSCRIBE SP unsubscribe_event |
12024 |
|
|
12025 |
</p> |
</p> |
|
<p>/ SELECT SP text |
|
|
|
|
|
</p> |
|
12026 |
<p>/ RESET SP reset_instruction |
<p>/ RESET SP reset_instruction |
12027 |
|
|
12028 |
</p> |
</p> |
12029 |
<p>/ CLEAR SP clear_instruction |
<p>/ CLEAR SP clear_instruction |
12030 |
|
|
12031 |
</p> |
</p> |
12032 |
|
<p>/ FIND SP find_instruction |
12033 |
|
|
12034 |
|
</p> |
12035 |
|
<p>/ MOVE SP move_instruction |
12036 |
|
|
12037 |
|
</p> |
12038 |
|
<p>/ COPY SP copy_instruction |
12039 |
|
|
12040 |
|
</p> |
12041 |
|
<p>/ EDIT SP edit_instruction |
12042 |
|
|
12043 |
|
</p> |
12044 |
|
<p>/ FORMAT SP format_instruction |
12045 |
|
|
12046 |
|
</p> |
12047 |
|
<p>/ SEND SP send_instruction |
12048 |
|
|
12049 |
|
</p> |
12050 |
|
<p>/ APPEND SP append_instruction |
12051 |
|
|
12052 |
|
</p> |
12053 |
|
<p>/ INSERT SP insert_instruction |
12054 |
|
|
12055 |
|
</p> |
12056 |
<p>/ RESET |
<p>/ RESET |
12057 |
|
|
12058 |
</p> |
</p> |
12068 |
<p>CHANNEL |
<p>CHANNEL |
12069 |
|
|
12070 |
</p> |
</p> |
12071 |
|
<p>/ CHANNEL SP MIDI_INPUT SP sampler_channel SP device_index |
12072 |
|
|
12073 |
|
</p> |
12074 |
|
<p>/ CHANNEL SP MIDI_INPUT SP sampler_channel SP device_index SP midi_input_port_index |
12075 |
|
|
12076 |
|
</p> |
12077 |
|
<p>/ DB_INSTRUMENT_DIRECTORY SP db_path |
12078 |
|
|
12079 |
|
</p> |
12080 |
|
<p>/ DB_INSTRUMENTS SP NON_MODAL SP scan_mode SP db_path SP filename |
12081 |
|
|
12082 |
|
</p> |
12083 |
|
<p>/ DB_INSTRUMENTS SP NON_MODAL SP scan_mode SP FILE_AS_DIR SP db_path SP filename |
12084 |
|
|
12085 |
|
</p> |
12086 |
|
<p>/ DB_INSTRUMENTS SP scan_mode SP db_path SP filename |
12087 |
|
|
12088 |
|
</p> |
12089 |
|
<p>/ DB_INSTRUMENTS SP scan_mode SP FILE_AS_DIR SP db_path SP filename |
12090 |
|
|
12091 |
|
</p> |
12092 |
|
<p>/ DB_INSTRUMENTS SP NON_MODAL SP db_path SP filename |
12093 |
|
|
12094 |
|
</p> |
12095 |
|
<p>/ DB_INSTRUMENTS SP NON_MODAL SP db_path SP filename SP instrument_index |
12096 |
|
|
12097 |
|
</p> |
12098 |
|
<p>/ DB_INSTRUMENTS SP db_path SP filename |
12099 |
|
|
12100 |
|
</p> |
12101 |
|
<p>/ DB_INSTRUMENTS SP db_path SP filename SP instrument_index |
12102 |
|
|
12103 |
|
</p> |
12104 |
<p>/ MIDI_INSTRUMENT_MAP |
<p>/ MIDI_INSTRUMENT_MAP |
12105 |
|
|
12106 |
</p> |
</p> |
12107 |
<p>/ MIDI_INSTRUMENT_MAP SP map_name |
<p>/ MIDI_INSTRUMENT_MAP SP map_name |
12108 |
|
|
12109 |
</p> |
</p> |
12110 |
|
<p>/ SEND_EFFECT_CHAIN SP device_index |
12111 |
|
|
12112 |
|
</p> |
12113 |
</blockquote><p> |
</blockquote><p> |
12114 |
|
|
12115 |
</p> |
</p> |
12116 |
<p>subscribe_event = |
<p>subscribe_event = |
12117 |
</p> |
</p> |
12118 |
<blockquote class="text"> |
<blockquote class="text"> |
12119 |
<p>CHANNEL_COUNT |
<p>AUDIO_OUTPUT_DEVICE_COUNT |
12120 |
|
|
12121 |
|
</p> |
12122 |
|
<p>/ AUDIO_OUTPUT_DEVICE_INFO |
12123 |
|
|
12124 |
|
</p> |
12125 |
|
<p>/ MIDI_INPUT_DEVICE_COUNT |
12126 |
|
|
12127 |
|
</p> |
12128 |
|
<p>/ MIDI_INPUT_DEVICE_INFO |
12129 |
|
|
12130 |
|
</p> |
12131 |
|
<p>/ CHANNEL_COUNT |
12132 |
|
|
12133 |
|
</p> |
12134 |
|
<p>/ CHANNEL_MIDI |
12135 |
|
|
12136 |
|
</p> |
12137 |
|
<p>/ DEVICE_MIDI |
12138 |
|
|
12139 |
</p> |
</p> |
12140 |
<p>/ VOICE_COUNT |
<p>/ VOICE_COUNT |
12149 |
<p>/ CHANNEL_INFO |
<p>/ CHANNEL_INFO |
12150 |
|
|
12151 |
</p> |
</p> |
12152 |
|
<p>/ FX_SEND_COUNT |
12153 |
|
|
12154 |
|
</p> |
12155 |
|
<p>/ FX_SEND_INFO |
12156 |
|
|
12157 |
|
</p> |
12158 |
|
<p>/ MIDI_INSTRUMENT_MAP_COUNT |
12159 |
|
|
12160 |
|
</p> |
12161 |
|
<p>/ MIDI_INSTRUMENT_MAP_INFO |
12162 |
|
|
12163 |
|
</p> |
12164 |
|
<p>/ MIDI_INSTRUMENT_COUNT |
12165 |
|
|
12166 |
|
</p> |
12167 |
|
<p>/ MIDI_INSTRUMENT_INFO |
12168 |
|
|
12169 |
|
</p> |
12170 |
|
<p>/ DB_INSTRUMENT_DIRECTORY_COUNT |
12171 |
|
|
12172 |
|
</p> |
12173 |
|
<p>/ DB_INSTRUMENT_DIRECTORY_INFO |
12174 |
|
|
12175 |
|
</p> |
12176 |
|
<p>/ DB_INSTRUMENT_COUNT |
12177 |
|
|
12178 |
|
</p> |
12179 |
|
<p>/ DB_INSTRUMENT_INFO |
12180 |
|
|
12181 |
|
</p> |
12182 |
|
<p>/ DB_INSTRUMENTS_JOB_INFO |
12183 |
|
|
12184 |
|
</p> |
12185 |
<p>/ MISCELLANEOUS |
<p>/ MISCELLANEOUS |
12186 |
|
|
12187 |
</p> |
</p> |
12188 |
|
<p>/ TOTAL_STREAM_COUNT |
12189 |
|
|
12190 |
|
</p> |
12191 |
<p>/ TOTAL_VOICE_COUNT |
<p>/ TOTAL_VOICE_COUNT |
12192 |
|
|
12193 |
</p> |
</p> |
12194 |
|
<p>/ GLOBAL_INFO |
12195 |
|
|
12196 |
|
</p> |
12197 |
|
<p>/ EFFECT_INSTANCE_COUNT |
12198 |
|
|
12199 |
|
</p> |
12200 |
|
<p>/ EFFECT_INSTANCE_INFO |
12201 |
|
|
12202 |
|
</p> |
12203 |
|
<p>/ SEND_EFFECT_CHAIN_COUNT |
12204 |
|
|
12205 |
|
</p> |
12206 |
|
<p>/ SEND_EFFECT_CHAIN_INFO |
12207 |
|
|
12208 |
|
</p> |
12209 |
</blockquote><p> |
</blockquote><p> |
12210 |
|
|
12211 |
</p> |
</p> |
12212 |
<p>unsubscribe_event = |
<p>unsubscribe_event = |
12213 |
</p> |
</p> |
12214 |
<blockquote class="text"> |
<blockquote class="text"> |
12215 |
<p>CHANNEL_COUNT |
<p>AUDIO_OUTPUT_DEVICE_COUNT |
12216 |
|
|
12217 |
|
</p> |
12218 |
|
<p>/ AUDIO_OUTPUT_DEVICE_INFO |
12219 |
|
|
12220 |
|
</p> |
12221 |
|
<p>/ MIDI_INPUT_DEVICE_COUNT |
12222 |
|
|
12223 |
|
</p> |
12224 |
|
<p>/ MIDI_INPUT_DEVICE_INFO |
12225 |
|
|
12226 |
|
</p> |
12227 |
|
<p>/ CHANNEL_COUNT |
12228 |
|
|
12229 |
|
</p> |
12230 |
|
<p>/ CHANNEL_MIDI |
12231 |
|
|
12232 |
|
</p> |
12233 |
|
<p>/ DEVICE_MIDI |
12234 |
|
|
12235 |
</p> |
</p> |
12236 |
<p>/ VOICE_COUNT |
<p>/ VOICE_COUNT |
12245 |
<p>/ CHANNEL_INFO |
<p>/ CHANNEL_INFO |
12246 |
|
|
12247 |
</p> |
</p> |
12248 |
|
<p>/ FX_SEND_COUNT |
12249 |
|
|
12250 |
|
</p> |
12251 |
|
<p>/ FX_SEND_INFO |
12252 |
|
|
12253 |
|
</p> |
12254 |
|
<p>/ MIDI_INSTRUMENT_MAP_COUNT |
12255 |
|
|
12256 |
|
</p> |
12257 |
|
<p>/ MIDI_INSTRUMENT_MAP_INFO |
12258 |
|
|
12259 |
|
</p> |
12260 |
|
<p>/ MIDI_INSTRUMENT_COUNT |
12261 |
|
|
12262 |
|
</p> |
12263 |
|
<p>/ MIDI_INSTRUMENT_INFO |
12264 |
|
|
12265 |
|
</p> |
12266 |
|
<p>/ DB_INSTRUMENT_DIRECTORY_COUNT |
12267 |
|
|
12268 |
|
</p> |
12269 |
|
<p>/ DB_INSTRUMENT_DIRECTORY_INFO |
12270 |
|
|
12271 |
|
</p> |
12272 |
|
<p>/ DB_INSTRUMENT_COUNT |
12273 |
|
|
12274 |
|
</p> |
12275 |
|
<p>/ DB_INSTRUMENT_INFO |
12276 |
|
|
12277 |
|
</p> |
12278 |
|
<p>/ DB_INSTRUMENTS_JOB_INFO |
12279 |
|
|
12280 |
|
</p> |
12281 |
<p>/ MISCELLANEOUS |
<p>/ MISCELLANEOUS |
12282 |
|
|
12283 |
</p> |
</p> |
12284 |
|
<p>/ TOTAL_STREAM_COUNT |
12285 |
|
|
12286 |
|
</p> |
12287 |
<p>/ TOTAL_VOICE_COUNT |
<p>/ TOTAL_VOICE_COUNT |
12288 |
|
|
12289 |
</p> |
</p> |
12290 |
|
<p>/ GLOBAL_INFO |
12291 |
|
|
12292 |
|
</p> |
12293 |
|
<p>/ EFFECT_INSTANCE_COUNT |
12294 |
|
|
12295 |
|
</p> |
12296 |
|
<p>/ EFFECT_INSTANCE_INFO |
12297 |
|
|
12298 |
|
</p> |
12299 |
|
<p>/ SEND_EFFECT_CHAIN_COUNT |
12300 |
|
|
12301 |
|
</p> |
12302 |
|
<p>/ SEND_EFFECT_CHAIN_INFO |
12303 |
|
|
12304 |
|
</p> |
12305 |
</blockquote><p> |
</blockquote><p> |
12306 |
|
|
12307 |
</p> |
</p> |
12308 |
<p>map_instruction = |
<p>map_instruction = |
12309 |
</p> |
</p> |
12310 |
<blockquote class="text"> |
<blockquote class="text"> |
12311 |
<p>MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value |
<p>MIDI_INSTRUMENT SP modal_arg midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value |
12312 |
|
|
12313 |
</p> |
</p> |
12314 |
<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 |
<p>/ MIDI_INSTRUMENT SP modal_arg midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode |
12315 |
|
|
12316 |
</p> |
</p> |
12317 |
<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 |
<p>/ MIDI_INSTRUMENT SP modal_arg midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP entry_name |
12318 |
|
|
12319 |
</p> |
</p> |
12320 |
<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 |
<p>/ MIDI_INSTRUMENT SP modal_arg 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 |
12321 |
|
|
12322 |
</p> |
</p> |
12323 |
</blockquote><p> |
</blockquote><p> |
12338 |
<p>CHANNEL SP sampler_channel |
<p>CHANNEL SP sampler_channel |
12339 |
|
|
12340 |
</p> |
</p> |
12341 |
|
<p>/ CHANNEL SP MIDI_INPUT SP sampler_channel |
12342 |
|
|
12343 |
|
</p> |
12344 |
|
<p>/ CHANNEL SP MIDI_INPUT SP sampler_channel SP device_index |
12345 |
|
|
12346 |
|
</p> |
12347 |
|
<p>/ CHANNEL SP MIDI_INPUT SP sampler_channel SP device_index SP midi_input_port_index |
12348 |
|
|
12349 |
|
</p> |
12350 |
<p>/ MIDI_INSTRUMENT_MAP SP midi_map |
<p>/ MIDI_INSTRUMENT_MAP SP midi_map |
12351 |
|
|
12352 |
</p> |
</p> |
12353 |
<p>/ MIDI_INSTRUMENT_MAP SP ALL |
<p>/ MIDI_INSTRUMENT_MAP SP ALL |
12354 |
|
|
12355 |
</p> |
</p> |
12356 |
|
<p>/ SEND_EFFECT_CHAIN SP device_index SP effect_chain |
12357 |
|
|
12358 |
|
</p> |
12359 |
|
<p>/ SEND_EFFECT_CHAIN SP EFFECT SP device_index SP effect_chain SP chain_pos |
12360 |
|
|
12361 |
|
</p> |
12362 |
|
<p>/ FX_SEND SP EFFECT SP sampler_channel SP fx_send_id |
12363 |
|
|
12364 |
|
</p> |
12365 |
|
<p>/ DB_INSTRUMENT_DIRECTORY SP FORCE SP db_path |
12366 |
|
|
12367 |
|
</p> |
12368 |
|
<p>/ DB_INSTRUMENT_DIRECTORY SP db_path |
12369 |
|
|
12370 |
|
</p> |
12371 |
|
<p>/ DB_INSTRUMENT SP db_path |
12372 |
|
|
12373 |
|
</p> |
12374 |
</blockquote><p> |
</blockquote><p> |
12375 |
|
|
12376 |
</p> |
</p> |
12380 |
<p>AVAILABLE_ENGINES |
<p>AVAILABLE_ENGINES |
12381 |
|
|
12382 |
</p> |
</p> |
12383 |
|
<p>/ AVAILABLE_EFFECTS |
12384 |
|
|
12385 |
|
</p> |
12386 |
|
<p>/ EFFECT_INSTANCES |
12387 |
|
|
12388 |
|
</p> |
12389 |
|
<p>/ EFFECT SP INFO SP effect_index |
12390 |
|
|
12391 |
|
</p> |
12392 |
|
<p>/ EFFECT_INSTANCE SP INFO SP effect_instance |
12393 |
|
|
12394 |
|
</p> |
12395 |
|
<p>/ EFFECT_INSTANCE_INPUT_CONTROL SP INFO SP effect_instance SP input_control |
12396 |
|
|
12397 |
|
</p> |
12398 |
|
<p>/ SEND_EFFECT_CHAINS SP device_index |
12399 |
|
|
12400 |
|
</p> |
12401 |
|
<p>/ SEND_EFFECT_CHAIN SP INFO SP device_index SP effect_chain |
12402 |
|
|
12403 |
|
</p> |
12404 |
<p>/ AVAILABLE_MIDI_INPUT_DRIVERS |
<p>/ AVAILABLE_MIDI_INPUT_DRIVERS |
12405 |
|
|
12406 |
</p> |
</p> |
12470 |
<p>/ SERVER SP INFO |
<p>/ SERVER SP INFO |
12471 |
|
|
12472 |
</p> |
</p> |
12473 |
|
<p>/ TOTAL_STREAM_COUNT |
12474 |
|
|
12475 |
|
</p> |
12476 |
<p>/ TOTAL_VOICE_COUNT |
<p>/ TOTAL_VOICE_COUNT |
12477 |
|
|
12478 |
</p> |
</p> |
12494 |
<p>/ MIDI_INSTRUMENT_MAP SP INFO SP midi_map |
<p>/ MIDI_INSTRUMENT_MAP SP INFO SP midi_map |
12495 |
|
|
12496 |
</p> |
</p> |
12497 |
|
<p>/ FX_SENDS SP sampler_channel |
12498 |
|
|
12499 |
|
</p> |
12500 |
|
<p>/ FX_SEND SP INFO SP sampler_channel SP fx_send_id |
12501 |
|
|
12502 |
|
</p> |
12503 |
|
<p>/ DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP db_path |
12504 |
|
|
12505 |
|
</p> |
12506 |
|
<p>/ DB_INSTRUMENT_DIRECTORIES SP db_path |
12507 |
|
|
12508 |
|
</p> |
12509 |
|
<p>/ DB_INSTRUMENT_DIRECTORY SP INFO SP db_path |
12510 |
|
|
12511 |
|
</p> |
12512 |
|
<p>/ DB_INSTRUMENTS SP RECURSIVE SP db_path |
12513 |
|
|
12514 |
|
</p> |
12515 |
|
<p>/ DB_INSTRUMENTS SP db_path |
12516 |
|
|
12517 |
|
</p> |
12518 |
|
<p>/ DB_INSTRUMENT SP INFO SP db_path |
12519 |
|
|
12520 |
|
</p> |
12521 |
|
<p>/ DB_INSTRUMENTS_JOB SP INFO SP number |
12522 |
|
|
12523 |
|
</p> |
12524 |
|
<p>/ VOLUME |
12525 |
|
|
12526 |
|
</p> |
12527 |
|
<p>/ VOICES |
12528 |
|
|
12529 |
|
</p> |
12530 |
|
<p>/ STREAMS |
12531 |
|
|
12532 |
|
</p> |
12533 |
|
<p>/ FILE SP INSTRUMENTS SP filename |
12534 |
|
|
12535 |
|
</p> |
12536 |
|
<p>/ FILE SP INSTRUMENT SP INFO SP filename SP instrument_index |
12537 |
|
|
12538 |
|
</p> |
12539 |
</blockquote><p> |
</blockquote><p> |
12540 |
|
|
12541 |
</p> |
</p> |
12551 |
<p>/ MIDI_INPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list |
<p>/ MIDI_INPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list |
12552 |
|
|
12553 |
</p> |
</p> |
12554 |
|
<p>/ MIDI_INPUT_PORT_PARAMETER SP number SP number SP string '=' NONE |
12555 |
|
|
12556 |
|
</p> |
12557 |
<p>/ MIDI_INPUT_PORT_PARAMETER SP number SP number SP string '=' param_val_list |
<p>/ MIDI_INPUT_PORT_PARAMETER SP number SP number SP string '=' param_val_list |
12558 |
|
|
12559 |
</p> |
</p> |
12560 |
|
<p>/ EFFECT_INSTANCE_INPUT_CONTROL SP VALUE SP effect_instance SP input_control SP control_value |
12561 |
|
|
12562 |
|
</p> |
12563 |
<p>/ CHANNEL SP set_chan_instruction |
<p>/ CHANNEL SP set_chan_instruction |
12564 |
|
|
12565 |
</p> |
</p> |
12566 |
<p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name |
<p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name |
12567 |
|
|
12568 |
</p> |
</p> |
12569 |
|
<p>/ FX_SEND SP NAME SP sampler_channel SP fx_send_id SP fx_send_name |
12570 |
|
|
12571 |
|
</p> |
12572 |
|
<p>/ FX_SEND SP AUDIO_OUTPUT_CHANNEL SP sampler_channel SP fx_send_id SP audio_channel_index SP audio_channel_index |
12573 |
|
|
12574 |
|
</p> |
12575 |
|
<p>/ FX_SEND SP MIDI_CONTROLLER SP sampler_channel SP fx_send_id SP midi_ctrl |
12576 |
|
|
12577 |
|
</p> |
12578 |
|
<p>/ FX_SEND SP LEVEL SP sampler_channel SP fx_send_id SP volume_value |
12579 |
|
|
12580 |
|
</p> |
12581 |
|
<p>/ FX_SEND SP EFFECT SP sampler_channel SP fx_send_id SP effect_chain SP chain_pos |
12582 |
|
|
12583 |
|
</p> |
12584 |
|
<p>/ DB_INSTRUMENT_DIRECTORY SP NAME SP db_path SP stringval_escaped |
12585 |
|
|
12586 |
|
</p> |
12587 |
|
<p>/ DB_INSTRUMENT_DIRECTORY SP DESCRIPTION SP db_path SP stringval_escaped |
12588 |
|
|
12589 |
|
</p> |
12590 |
|
<p>/ DB_INSTRUMENT SP NAME SP db_path SP stringval_escaped |
12591 |
|
|
12592 |
|
</p> |
12593 |
|
<p>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped |
12594 |
|
|
12595 |
|
</p> |
12596 |
|
<p>/ DB_INSTRUMENT SP FILE_PATH SP filename SP filename |
12597 |
|
|
12598 |
|
</p> |
12599 |
<p>/ ECHO SP boolean |
<p>/ ECHO SP boolean |
12600 |
|
|
12601 |
</p> |
</p> |
12602 |
|
<p>/ VOLUME SP volume_value |
12603 |
|
|
12604 |
|
</p> |
12605 |
|
<p>/ VOICES SP number |
12606 |
|
|
12607 |
|
</p> |
12608 |
|
<p>/ STREAMS SP number |
12609 |
|
|
12610 |
|
</p> |
12611 |
</blockquote><p> |
</blockquote><p> |
12612 |
|
|
12613 |
</p> |
</p> |
12626 |
<p>/ MIDI_INPUT_DEVICE SP string |
<p>/ MIDI_INPUT_DEVICE SP string |
12627 |
|
|
12628 |
</p> |
</p> |
12629 |
|
<p>/ FX_SEND SP sampler_channel SP midi_ctrl |
12630 |
|
|
12631 |
|
</p> |
12632 |
|
<p>/ FX_SEND SP sampler_channel SP midi_ctrl SP fx_send_name |
12633 |
|
|
12634 |
|
</p> |
12635 |
|
<p>/ EFFECT_INSTANCE SP effect_index |
12636 |
|
|
12637 |
|
</p> |
12638 |
|
<p>/ EFFECT_INSTANCE SP effect_system SP module SP effect_name |
12639 |
|
|
12640 |
|
</p> |
12641 |
</blockquote><p> |
</blockquote><p> |
12642 |
|
|
12643 |
</p> |
</p> |
12662 |
</blockquote><p> |
</blockquote><p> |
12663 |
|
|
12664 |
</p> |
</p> |
12665 |
|
<p>find_instruction = |
12666 |
|
</p> |
12667 |
|
<blockquote class="text"> |
12668 |
|
<p>DB_INSTRUMENTS SP NON_RECURSIVE SP db_path SP query_val_list |
12669 |
|
|
12670 |
|
</p> |
12671 |
|
<p>/ DB_INSTRUMENTS SP db_path SP query_val_list |
12672 |
|
|
12673 |
|
</p> |
12674 |
|
<p>/ DB_INSTRUMENT_DIRECTORIES SP NON_RECURSIVE SP db_path SP query_val_list |
12675 |
|
|
12676 |
|
</p> |
12677 |
|
<p>/ DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list |
12678 |
|
|
12679 |
|
</p> |
12680 |
|
<p>/ LOST SP DB_INSTRUMENT_FILES |
12681 |
|
|
12682 |
|
</p> |
12683 |
|
</blockquote><p> |
12684 |
|
|
12685 |
|
</p> |
12686 |
|
<p>move_instruction = |
12687 |
|
</p> |
12688 |
|
<blockquote class="text"> |
12689 |
|
<p>DB_INSTRUMENT_DIRECTORY SP db_path SP db_path |
12690 |
|
|
12691 |
|
</p> |
12692 |
|
<p>/ DB_INSTRUMENT SP db_path SP db_path |
12693 |
|
|
12694 |
|
</p> |
12695 |
|
</blockquote><p> |
12696 |
|
|
12697 |
|
</p> |
12698 |
|
<p>copy_instruction = |
12699 |
|
</p> |
12700 |
|
<blockquote class="text"> |
12701 |
|
<p>DB_INSTRUMENT_DIRECTORY SP db_path SP db_path |
12702 |
|
|
12703 |
|
</p> |
12704 |
|
<p>/ DB_INSTRUMENT SP db_path SP db_path |
12705 |
|
|
12706 |
|
</p> |
12707 |
|
</blockquote><p> |
12708 |
|
|
12709 |
|
</p> |
12710 |
<p>destroy_instruction = |
<p>destroy_instruction = |
12711 |
</p> |
</p> |
12712 |
<blockquote class="text"> |
<blockquote class="text"> |
12716 |
<p>/ MIDI_INPUT_DEVICE SP number |
<p>/ MIDI_INPUT_DEVICE SP number |
12717 |
|
|
12718 |
</p> |
</p> |
12719 |
|
<p>/ FX_SEND SP sampler_channel SP fx_send_id |
12720 |
|
|
12721 |
|
</p> |
12722 |
|
<p>/ EFFECT_INSTANCE SP number |
12723 |
|
|
12724 |
|
</p> |
12725 |
</blockquote><p> |
</blockquote><p> |
12726 |
|
|
12727 |
</p> |
</p> |
12737 |
</blockquote><p> |
</blockquote><p> |
12738 |
|
|
12739 |
</p> |
</p> |
12740 |
|
<p>append_instruction = |
12741 |
|
</p> |
12742 |
|
<blockquote class="text"> |
12743 |
|
<p>SEND_EFFECT_CHAIN SP EFFECT SP device_index SP effect_chain SP effect_instance |
12744 |
|
|
12745 |
|
</p> |
12746 |
|
</blockquote><p> |
12747 |
|
|
12748 |
|
</p> |
12749 |
|
<p>insert_instruction = |
12750 |
|
</p> |
12751 |
|
<blockquote class="text"> |
12752 |
|
<p>SEND_EFFECT_CHAIN SP EFFECT SP device_index SP effect_chain SP chain_pos SP effect_instance |
12753 |
|
|
12754 |
|
</p> |
12755 |
|
</blockquote><p> |
12756 |
|
|
12757 |
|
</p> |
12758 |
<p>set_chan_instruction = |
<p>set_chan_instruction = |
12759 |
</p> |
</p> |
12760 |
<blockquote class="text"> |
<blockquote class="text"> |
12803 |
</blockquote><p> |
</blockquote><p> |
12804 |
|
|
12805 |
</p> |
</p> |
12806 |
|
<p>edit_instruction = |
12807 |
|
</p> |
12808 |
|
<blockquote class="text"> |
12809 |
|
<p>CHANNEL SP INSTRUMENT SP sampler_channel |
12810 |
|
|
12811 |
|
</p> |
12812 |
|
</blockquote><p> |
12813 |
|
|
12814 |
|
</p> |
12815 |
|
<p>format_instruction = |
12816 |
|
</p> |
12817 |
|
<blockquote class="text"> |
12818 |
|
<p>INSTRUMENTS_DB |
12819 |
|
|
12820 |
|
</p> |
12821 |
|
</blockquote><p> |
12822 |
|
|
12823 |
|
</p> |
12824 |
|
<p>modal_arg = |
12825 |
|
</p> |
12826 |
|
<blockquote class="text"> |
12827 |
|
<p>/* epsilon (empty argument) */ |
12828 |
|
|
12829 |
|
</p> |
12830 |
|
<p>/ NON_MODAL SP |
12831 |
|
|
12832 |
|
</p> |
12833 |
|
</blockquote><p> |
12834 |
|
|
12835 |
|
</p> |
12836 |
<p>key_val_list = |
<p>key_val_list = |
12837 |
</p> |
</p> |
12838 |
<blockquote class="text"> |
<blockquote class="text"> |
12869 |
<p>/ CHANNELS |
<p>/ CHANNELS |
12870 |
|
|
12871 |
</p> |
</p> |
12872 |
|
<p>/ CHANNEL SP MIDI_INPUTS SP sampler_channel |
12873 |
|
|
12874 |
|
</p> |
12875 |
<p>/ AVAILABLE_ENGINES |
<p>/ AVAILABLE_ENGINES |
12876 |
|
|
12877 |
</p> |
</p> |
12878 |
|
<p>/ AVAILABLE_EFFECTS |
12879 |
|
|
12880 |
|
</p> |
12881 |
|
<p>/ EFFECT_INSTANCES |
12882 |
|
|
12883 |
|
</p> |
12884 |
|
<p>/ SEND_EFFECT_CHAINS SP number |
12885 |
|
|
12886 |
|
</p> |
12887 |
<p>/ AVAILABLE_MIDI_INPUT_DRIVERS |
<p>/ AVAILABLE_MIDI_INPUT_DRIVERS |
12888 |
|
|
12889 |
</p> |
</p> |
12899 |
<p>/ MIDI_INSTRUMENT_MAPS |
<p>/ MIDI_INSTRUMENT_MAPS |
12900 |
|
|
12901 |
</p> |
</p> |
12902 |
|
<p>/ FX_SENDS SP sampler_channel |
12903 |
|
|
12904 |
|
</p> |
12905 |
|
<p>/ DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP db_path |
12906 |
|
|
12907 |
|
</p> |
12908 |
|
<p>/ DB_INSTRUMENT_DIRECTORIES SP db_path |
12909 |
|
|
12910 |
|
</p> |
12911 |
|
<p>/ DB_INSTRUMENTS SP RECURSIVE SP db_path |
12912 |
|
|
12913 |
|
</p> |
12914 |
|
<p>/ DB_INSTRUMENTS SP db_path |
12915 |
|
|
12916 |
|
</p> |
12917 |
|
<p>/ FILE SP INSTRUMENTS SP filename |
12918 |
|
|
12919 |
|
</p> |
12920 |
|
</blockquote><p> |
12921 |
|
|
12922 |
|
</p> |
12923 |
|
<p>send_instruction = |
12924 |
|
</p> |
12925 |
|
<blockquote class="text"> |
12926 |
|
<p>CHANNEL SP MIDI_DATA SP string SP sampler_channel SP number SP number |
12927 |
|
|
12928 |
|
</p> |
12929 |
</blockquote><p> |
</blockquote><p> |
12930 |
|
|
12931 |
</p> |
</p> |
12965 |
</blockquote><p> |
</blockquote><p> |
12966 |
|
|
12967 |
</p> |
</p> |
12968 |
|
<p>effect_instance = |
12969 |
|
</p> |
12970 |
|
<blockquote class="text"> |
12971 |
|
<p>number |
12972 |
|
|
12973 |
|
</p> |
12974 |
|
</blockquote><p> |
12975 |
|
|
12976 |
|
</p> |
12977 |
<p>device_index = |
<p>device_index = |
12978 |
</p> |
</p> |
12979 |
<blockquote class="text"> |
<blockquote class="text"> |
13058 |
</blockquote><p> |
</blockquote><p> |
13059 |
|
|
13060 |
</p> |
</p> |
13061 |
|
<p>midi_ctrl = |
13062 |
|
</p> |
13063 |
|
<blockquote class="text"> |
13064 |
|
<p>number |
13065 |
|
|
13066 |
|
</p> |
13067 |
|
</blockquote><p> |
13068 |
|
|
13069 |
|
</p> |
13070 |
<p>volume_value = |
<p>volume_value = |
13071 |
</p> |
</p> |
13072 |
<blockquote class="text"> |
<blockquote class="text"> |
13079 |
</blockquote><p> |
</blockquote><p> |
13080 |
|
|
13081 |
</p> |
</p> |
13082 |
|
<p>control_value = |
13083 |
|
</p> |
13084 |
|
<blockquote class="text"> |
13085 |
|
<p>real |
13086 |
|
|
13087 |
|
</p> |
13088 |
|
</blockquote><p> |
13089 |
|
|
13090 |
|
</p> |
13091 |
<p>sampler_channel = |
<p>sampler_channel = |
13092 |
</p> |
</p> |
13093 |
<blockquote class="text"> |
<blockquote class="text"> |
13106 |
</blockquote><p> |
</blockquote><p> |
13107 |
|
|
13108 |
</p> |
</p> |
13109 |
|
<p>fx_send_id = |
13110 |
|
</p> |
13111 |
|
<blockquote class="text"> |
13112 |
|
<p>number |
13113 |
|
|
13114 |
|
</p> |
13115 |
|
</blockquote><p> |
13116 |
|
|
13117 |
|
</p> |
13118 |
<p>engine_name = |
<p>engine_name = |
13119 |
</p> |
</p> |
13120 |
<blockquote class="text"> |
<blockquote class="text"> |
13127 |
<p>filename = |
<p>filename = |
13128 |
</p> |
</p> |
13129 |
<blockquote class="text"> |
<blockquote class="text"> |
13130 |
<p>stringval |
<p>path |
13131 |
|
|
13132 |
|
</p> |
13133 |
|
</blockquote><p> |
13134 |
|
|
13135 |
|
</p> |
13136 |
|
<p>db_path = |
13137 |
|
</p> |
13138 |
|
<blockquote class="text"> |
13139 |
|
<p>path |
13140 |
|
|
13141 |
</p> |
</p> |
13142 |
</blockquote><p> |
</blockquote><p> |
13145 |
<p>map_name = |
<p>map_name = |
13146 |
</p> |
</p> |
13147 |
<blockquote class="text"> |
<blockquote class="text"> |
13148 |
<p>stringval |
<p>stringval_escaped |
13149 |
|
|
13150 |
</p> |
</p> |
13151 |
</blockquote><p> |
</blockquote><p> |
13154 |
<p>entry_name = |
<p>entry_name = |
13155 |
</p> |
</p> |
13156 |
<blockquote class="text"> |
<blockquote class="text"> |
13157 |
<p>stringval |
<p>stringval_escaped |
13158 |
|
|
13159 |
|
</p> |
13160 |
|
</blockquote><p> |
13161 |
|
|
13162 |
|
</p> |
13163 |
|
<p>fx_send_name = |
13164 |
|
</p> |
13165 |
|
<blockquote class="text"> |
13166 |
|
<p>stringval_escaped |
13167 |
|
|
13168 |
|
</p> |
13169 |
|
</blockquote><p> |
13170 |
|
|
13171 |
|
</p> |
13172 |
|
<p>effect_name = |
13173 |
|
</p> |
13174 |
|
<blockquote class="text"> |
13175 |
|
<p>stringval_escaped |
13176 |
|
|
13177 |
|
</p> |
13178 |
|
</blockquote><p> |
13179 |
|
|
13180 |
|
</p> |
13181 |
|
<p>effect_index = |
13182 |
|
</p> |
13183 |
|
<blockquote class="text"> |
13184 |
|
<p>number |
13185 |
|
|
13186 |
|
</p> |
13187 |
|
</blockquote><p> |
13188 |
|
|
13189 |
|
</p> |
13190 |
|
<p>effect_chain = |
13191 |
|
</p> |
13192 |
|
<blockquote class="text"> |
13193 |
|
<p>number |
13194 |
|
|
13195 |
|
</p> |
13196 |
|
</blockquote><p> |
13197 |
|
|
13198 |
|
</p> |
13199 |
|
<p>chain_pos = |
13200 |
|
</p> |
13201 |
|
<blockquote class="text"> |
13202 |
|
<p>number |
13203 |
|
|
13204 |
|
</p> |
13205 |
|
</blockquote><p> |
13206 |
|
|
13207 |
|
</p> |
13208 |
|
<p>input_control = |
13209 |
|
</p> |
13210 |
|
<blockquote class="text"> |
13211 |
|
<p>number |
13212 |
|
|
13213 |
</p> |
</p> |
13214 |
</blockquote><p> |
</blockquote><p> |
13244 |
</blockquote><p> |
</blockquote><p> |
13245 |
|
|
13246 |
</p> |
</p> |
13247 |
|
<p>query_val_list = |
13248 |
|
</p> |
13249 |
|
<blockquote class="text"> |
13250 |
|
<p>string '=' query_val |
13251 |
|
|
13252 |
|
</p> |
13253 |
|
<p>/ query_val_list SP string '=' query_val |
13254 |
|
|
13255 |
|
</p> |
13256 |
|
</blockquote><p> |
13257 |
|
|
13258 |
|
</p> |
13259 |
|
<p>query_val = |
13260 |
|
</p> |
13261 |
|
<blockquote class="text"> |
13262 |
|
<p>text_escaped |
13263 |
|
|
13264 |
|
</p> |
13265 |
|
<p>/ stringval_escaped |
13266 |
|
|
13267 |
|
</p> |
13268 |
|
</blockquote><p> |
13269 |
|
|
13270 |
|
</p> |
13271 |
|
<p>scan_mode = |
13272 |
|
</p> |
13273 |
|
<blockquote class="text"> |
13274 |
|
<p>RECURSIVE |
13275 |
|
|
13276 |
|
</p> |
13277 |
|
<p>/ NON_RECURSIVE |
13278 |
|
|
13279 |
|
</p> |
13280 |
|
<p>/ FLAT |
13281 |
|
|
13282 |
|
</p> |
13283 |
|
</blockquote><p> |
13284 |
|
|
13285 |
|
</p> |
13286 |
|
<p>effect_system = |
13287 |
|
</p> |
13288 |
|
<blockquote class="text"> |
13289 |
|
<p>string |
13290 |
|
|
13291 |
|
</p> |
13292 |
|
</blockquote><p> |
13293 |
|
|
13294 |
|
</p> |
13295 |
|
<p>module = |
13296 |
|
</p> |
13297 |
|
<blockquote class="text"> |
13298 |
|
<p>filename |
13299 |
|
|
13300 |
|
</p> |
13301 |
|
</blockquote><p> |
13302 |
|
|
13303 |
|
</p> |
13304 |
|
<a name="character_set"></a><br /><hr /> |
13305 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13306 |
|
<a name="rfc.section.7.1"></a><h3>7.1. |
13307 |
|
Character Set and Escape Sequences</h3> |
13308 |
|
|
13309 |
|
<p>Older versions of this protocol up to and including v1.1 only |
13310 |
|
supported the standard ASCII character set (ASCII code 0 - 127) |
13311 |
|
<a class='info' href='#RFC20'>[RFC20]<span> (</span><span class='info'>UCLA, “ASCII format for Network Interchange,” 1969.</span><span>)</span></a>, all younger versions of this protocol |
13312 |
|
however support the Extended ASCII character set (ASCII code |
13313 |
|
0 - 255). The same group of younger protocols also support |
13314 |
|
escape sequences, but only for certain, explicitly declared |
13315 |
|
parts of the protocol. The supported escape sequences are |
13316 |
|
defined as follows: |
13317 |
|
</p><table class="full" align="center" border="0" cellpadding="2" cellspacing="2"> |
13318 |
|
<col align="left"><col align="left"> |
13319 |
|
<tr><th align="left">ASCII Character Sequence</th><th align="left">Translated into (Name)</th></tr> |
13320 |
|
<tr> |
13321 |
|
<td align="left">\n</td> |
13322 |
|
<td align="left">new line</td> |
13323 |
|
</tr> |
13324 |
|
<tr> |
13325 |
|
<td align="left">\r</td> |
13326 |
|
<td align="left">carriage return</td> |
13327 |
|
</tr> |
13328 |
|
<tr> |
13329 |
|
<td align="left">\f</td> |
13330 |
|
<td align="left">form feed</td> |
13331 |
|
</tr> |
13332 |
|
<tr> |
13333 |
|
<td align="left">\t</td> |
13334 |
|
<td align="left">horizontal tab</td> |
13335 |
|
</tr> |
13336 |
|
<tr> |
13337 |
|
<td align="left">\v</td> |
13338 |
|
<td align="left">vertical tab</td> |
13339 |
|
</tr> |
13340 |
|
<tr> |
13341 |
|
<td align="left">\'</td> |
13342 |
|
<td align="left">apostrophe</td> |
13343 |
|
</tr> |
13344 |
|
<tr> |
13345 |
|
<td align="left">\"</td> |
13346 |
|
<td align="left">quotation mark</td> |
13347 |
|
</tr> |
13348 |
|
<tr> |
13349 |
|
<td align="left">\\</td> |
13350 |
|
<td align="left">backslash</td> |
13351 |
|
</tr> |
13352 |
|
<tr> |
13353 |
|
<td align="left">\OOO</td> |
13354 |
|
<td align="left">three digit octal ASCII code of the character</td> |
13355 |
|
</tr> |
13356 |
|
<tr> |
13357 |
|
<td align="left">\xHH</td> |
13358 |
|
<td align="left">two digit hex ASCII code of the character</td> |
13359 |
|
</tr> |
13360 |
|
</table> |
13361 |
|
<br clear="all" /> |
13362 |
|
|
13363 |
|
<p>Notice: due to the transition of certain parts of the |
13364 |
|
protocol which now support escape sequences, a slight backward |
13365 |
|
incompatibility to protocols version v1.1 and younger has been |
13366 |
|
introduced. The only difference is that in parts of the protocol |
13367 |
|
where escape characters are now supported, a backslash characters |
13368 |
|
MUST be escaped as well (that is as double backslash), whereas |
13369 |
|
in the old versions a single backslash was sufficient. |
13370 |
|
</p> |
13371 |
|
<p>The following LSCP commands support escape sequences as part |
13372 |
|
of their filename / path based arguments and / or may contain |
13373 |
|
a filename / path with escape sequences in their response: |
13374 |
|
</p> |
13375 |
|
<blockquote class="text"> |
13376 |
|
<p><a class='info' href='#LOAD INSTRUMENT'>"LOAD INSTRUMENT"<span> (</span><span class='info'>Loading an instrument</span><span>)</span></a> |
13377 |
|
</p> |
13378 |
|
<p><a class='info' href='#GET CHANNEL INFO'>"GET CHANNEL INFO"<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a> |
13379 |
|
</p> |
13380 |
|
<p><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> |
13381 |
|
</p> |
13382 |
|
<p><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> |
13383 |
|
</p> |
13384 |
|
<p><a class='info' href='#ADD DB_INSTRUMENT_DIRECTORY'>"ADD DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Creating a new instrument directory</span><span>)</span></a> |
13385 |
|
</p> |
13386 |
|
<p><a class='info' href='#ADD DB_INSTRUMENTS'>"ADD DB_INSTRUMENTS"<span> (</span><span class='info'>Adding instruments to the instruments database</span><span>)</span></a> |
13387 |
|
</p> |
13388 |
|
<p><a class='info' href='#REMOVE DB_INSTRUMENT_DIRECTORY'>"REMOVE DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Deleting an instrument directory</span><span>)</span></a> |
13389 |
|
</p> |
13390 |
|
<p><a class='info' href='#REMOVE DB_INSTRUMENT'>"REMOVE DB_INSTRUMENT"<span> (</span><span class='info'>Removing an instrument</span><span>)</span></a> |
13391 |
|
</p> |
13392 |
|
<p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORIES'>"GET DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Getting amount of instrument directories</span><span>)</span></a> |
13393 |
|
</p> |
13394 |
|
<p><a class='info' href='#LIST DB_INSTRUMENT_DIRECTORIES'>"LIST DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Listing all directories in specific directory</span><span>)</span></a> |
13395 |
|
</p> |
13396 |
|
<p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORY INFO'>"GET DB_INSTRUMENT_DIRECTORY INFO"<span> (</span><span class='info'>Getting instrument directory information</span><span>)</span></a> |
13397 |
|
</p> |
13398 |
|
<p><a class='info' href='#GET DB_INSTRUMENTS'>"GET DB_INSTRUMENTS"<span> (</span><span class='info'>Getting amount of instruments</span><span>)</span></a> |
13399 |
|
</p> |
13400 |
|
<p><a class='info' href='#LIST DB_INSTRUMENTS'>"LIST DB_INSTRUMENTS"<span> (</span><span class='info'>Listing all instruments in specific directory</span><span>)</span></a> |
13401 |
|
</p> |
13402 |
|
<p><a class='info' href='#GET DB_INSTRUMENT INFO'>"GET DB_INSTRUMENT INFO"<span> (</span><span class='info'>Getting instrument information</span><span>)</span></a> |
13403 |
|
</p> |
13404 |
|
<p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY NAME'>"SET DB_INSTRUMENT_DIRECTORY NAME"<span> (</span><span class='info'>Renaming an instrument directory</span><span>)</span></a> |
13405 |
|
</p> |
13406 |
|
<p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY DESCRIPTION'>"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"<span> (</span><span class='info'>Changing the description of directory</span><span>)</span></a> |
13407 |
|
</p> |
13408 |
|
<p><a class='info' href='#SET DB_INSTRUMENT NAME'>"SET DB_INSTRUMENT NAME"<span> (</span><span class='info'>Renaming an instrument</span><span>)</span></a> |
13409 |
|
</p> |
13410 |
|
<p><a class='info' href='#SET DB_INSTRUMENT DESCRIPTION'>"SET DB_INSTRUMENT DESCRIPTION"<span> (</span><span class='info'>Changing the description of instrument</span><span>)</span></a> |
13411 |
|
</p> |
13412 |
|
<p><a class='info' href='#FIND DB_INSTRUMENTS'>"FIND DB_INSTRUMENTS"<span> (</span><span class='info'>Finding instruments</span><span>)</span></a> |
13413 |
|
</p> |
13414 |
|
<p><a class='info' href='#FIND DB_INSTRUMENT_DIRECTORIES'>"FIND DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Finding directories</span><span>)</span></a> |
13415 |
|
</p> |
13416 |
|
<p><a class='info' href='#MOVE DB_INSTRUMENT'>"MOVE DB_INSTRUMENT"<span> (</span><span class='info'>Moving an instrument</span><span>)</span></a> |
13417 |
|
</p> |
13418 |
|
<p><a class='info' href='#MOVE DB_INSTRUMENT_DIRECTORY'>"MOVE DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Moving an instrument directory</span><span>)</span></a> |
13419 |
|
</p> |
13420 |
|
<p><a class='info' href='#COPY DB_INSTRUMENT'>"COPY DB_INSTRUMENT"<span> (</span><span class='info'>Copying instruments</span><span>)</span></a> |
13421 |
|
</p> |
13422 |
|
<p><a class='info' href='#COPY DB_INSTRUMENT_DIRECTORY'>"COPY DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Copying instrument directories</span><span>)</span></a> |
13423 |
|
</p> |
13424 |
|
<p><a class='info' href='#FIND LOST DB_INSTRUMENT_FILES'>"FIND LOST DB_INSTRUMENT_FILES"<span> (</span><span class='info'>Checking for lost instrument files</span><span>)</span></a> |
13425 |
|
</p> |
13426 |
|
<p><a class='info' href='#SET DB_INSTRUMENT FILE_PATH'>"SET DB_INSTRUMENT FILE_PATH"<span> (</span><span class='info'>Replacing an instrument file</span><span>)</span></a> |
13427 |
|
</p> |
13428 |
|
<p><a class='info' href='#GET FILE INSTRUMENTS'>"GET FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving amount of instruments of a file</span><span>)</span></a> |
13429 |
|
</p> |
13430 |
|
<p><a class='info' href='#LIST FILE INSTRUMENTS'>"LIST FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving all instruments of a file</span><span>)</span></a> |
13431 |
|
</p> |
13432 |
|
<p><a class='info' href='#GET FILE INSTRUMENT INFO'>"GET FILE INSTRUMENT INFO"<span> (</span><span class='info'>Retrieving informations about one instrument in a file</span><span>)</span></a> |
13433 |
|
</p> |
13434 |
|
<p><a class='info' href='#GET EFFECT INFO'>"GET EFFECT INFO"<span> (</span><span class='info'>Retrieving general information about an effect</span><span>)</span></a> |
13435 |
|
</p> |
13436 |
|
<p><a class='info' href='#GET EFFECT_INSTANCE INFO'>"GET EFFECT_INSTANCE INFO"<span> (</span><span class='info'>Retrieving current information about an effect instance</span><span>)</span></a> |
13437 |
|
</p> |
13438 |
|
<p><a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> |
13439 |
|
</p> |
13440 |
|
</blockquote><p> |
13441 |
|
Note that the forward slash character ('/') has a special meaning in |
13442 |
|
filename / path based arguments: it acts as separator of the nodes in |
13443 |
|
the path, thus if a directory- or filename includes a forward slash |
13444 |
|
(not intended as path node separator), you MUST escape that slash |
13445 |
|
either with the respective hex escape sequence ("\x2f") or with the |
13446 |
|
respective octal escape sequence ("\057"). |
13447 |
|
|
13448 |
|
</p> |
13449 |
|
<p> |
13450 |
|
Note for Windows: file path arguments in LSCP are expected |
13451 |
|
to use forward slashes as directory node separator similar |
13452 |
|
to Unix based operating systems. In contrast to Unix however |
13453 |
|
a Windows typical drive character is expected to be |
13454 |
|
prefixed to the path. That is an original Windows file path |
13455 |
|
like "D:\Sounds\My.gig" would become in LSCP: |
13456 |
|
"D:/Sounds/My.gig". |
13457 |
|
|
13458 |
|
</p> |
13459 |
|
<p> |
13460 |
|
The following LSCP commands even support escape sequences as |
13461 |
|
part of at least one of their text-based arguments (i.e. entity name, |
13462 |
|
description) and / or may contain escape sequences in at least one of |
13463 |
|
their text-based fields in their response: |
13464 |
|
</p> |
13465 |
|
<blockquote class="text"> |
13466 |
|
<p><a class='info' href='#GET SERVER INFO'>"GET SERVER INFO"<span> (</span><span class='info'>General sampler informations</span><span>)</span></a> |
13467 |
|
</p> |
13468 |
|
<p><a class='info' href='#GET ENGINE INFO'>"GET ENGINE INFO"<span> (</span><span class='info'>Getting information about an engine</span><span>)</span></a> |
13469 |
|
</p> |
13470 |
|
<p><a class='info' href='#GET CHANNEL INFO'>"GET CHANNEL INFO"<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a> |
13471 |
|
</p> |
13472 |
|
<p><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> |
13473 |
|
</p> |
13474 |
|
<p><a class='info' href='#GET FX_SEND INFO'>"GET FX_SEND INFO"<span> (</span><span class='info'>Getting effect send information</span><span>)</span></a> |
13475 |
|
</p> |
13476 |
|
<p><a class='info' href='#SET FX_SEND NAME'>"SET FX_SEND NAME"<span> (</span><span class='info'>Changing effect send's name</span><span>)</span></a> |
13477 |
|
</p> |
13478 |
|
<p><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> |
13479 |
|
</p> |
13480 |
|
<p><a class='info' href='#GET MIDI_INSTRUMENT_MAP INFO'>"GET MIDI_INSTRUMENT_MAP INFO"<span> (</span><span class='info'>Getting MIDI instrument map information</span><span>)</span></a> |
13481 |
|
</p> |
13482 |
|
<p><a class='info' href='#ADD MIDI_INSTRUMENT_MAP'>"ADD MIDI_INSTRUMENT_MAP"<span> (</span><span class='info'>Create a new MIDI instrument map</span><span>)</span></a> |
13483 |
|
</p> |
13484 |
|
<p><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> |
13485 |
|
</p> |
13486 |
|
<p><a class='info' href='#SET MIDI_INSTRUMENT_MAP NAME'>"SET MIDI_INSTRUMENT_MAP NAME"<span> (</span><span class='info'>Renaming a MIDI instrument map</span><span>)</span></a> |
13487 |
|
</p> |
13488 |
|
<p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORY INFO'>"GET DB_INSTRUMENT_DIRECTORY INFO"<span> (</span><span class='info'>Getting instrument directory information</span><span>)</span></a> |
13489 |
|
</p> |
13490 |
|
<p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY NAME'>"SET DB_INSTRUMENT_DIRECTORY NAME"<span> (</span><span class='info'>Renaming an instrument directory</span><span>)</span></a> |
13491 |
|
</p> |
13492 |
|
<p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY DESCRIPTION'>"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"<span> (</span><span class='info'>Changing the description of directory</span><span>)</span></a> |
13493 |
|
</p> |
13494 |
|
<p><a class='info' href='#FIND DB_INSTRUMENT_DIRECTORIES'>"FIND DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Finding directories</span><span>)</span></a> |
13495 |
|
</p> |
13496 |
|
<p><a class='info' href='#GET DB_INSTRUMENT INFO'>"GET DB_INSTRUMENT INFO"<span> (</span><span class='info'>Getting instrument information</span><span>)</span></a> |
13497 |
|
</p> |
13498 |
|
<p><a class='info' href='#SET DB_INSTRUMENT NAME'>"SET DB_INSTRUMENT NAME"<span> (</span><span class='info'>Renaming an instrument</span><span>)</span></a> |
13499 |
|
</p> |
13500 |
|
<p><a class='info' href='#SET DB_INSTRUMENT DESCRIPTION'>"SET DB_INSTRUMENT DESCRIPTION"<span> (</span><span class='info'>Changing the description of instrument</span><span>)</span></a> |
13501 |
|
</p> |
13502 |
|
<p><a class='info' href='#FIND DB_INSTRUMENTS'>"FIND DB_INSTRUMENTS"<span> (</span><span class='info'>Finding instruments</span><span>)</span></a> |
13503 |
|
</p> |
13504 |
|
<p><a class='info' href='#GET EFFECT INFO'>"GET EFFECT INFO"<span> (</span><span class='info'>Retrieving general information about an effect</span><span>)</span></a> |
13505 |
|
</p> |
13506 |
|
<p><a class='info' href='#GET EFFECT_INSTANCE INFO'>"GET EFFECT_INSTANCE INFO"<span> (</span><span class='info'>Retrieving current information about an effect instance</span><span>)</span></a> |
13507 |
|
</p> |
13508 |
|
<p><a class='info' href='#CREATE EFFECT_INSTANCE'>"CREATE EFFECT_INSTANCE"<span> (</span><span class='info'>Creating an instance of an effect by its portable ID</span><span>)</span></a> |
13509 |
|
</p> |
13510 |
|
</blockquote><p> |
13511 |
|
Please note that these lists are manually maintained. If you |
13512 |
|
find a command that also supports escape sequences we forgot to |
13513 |
|
mention here, please report it! |
13514 |
|
|
13515 |
|
</p> |
13516 |
<a name="events"></a><br /><hr /> |
<a name="events"></a><br /><hr /> |
13517 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13518 |
<a name="rfc.section.8"></a><h3>8. |
<a name="rfc.section.8"></a><h3>8. |
13520 |
|
|
13521 |
<p>This chapter will describe all currently defined events supported by LinuxSampler. |
<p>This chapter will describe all currently defined events supported by LinuxSampler. |
13522 |
</p> |
</p> |
13523 |
<a name="SUBSCRIBE CHANNEL"></a><br /><hr /> |
<a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT"></a><br /><hr /> |
13524 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13525 |
<a name="rfc.section.8.1"></a><h3>8.1. |
<a name="rfc.section.8.1"></a><h3>8.1. |
13526 |
|
Number of audio output devices changed</h3> |
13527 |
|
|
13528 |
|
<p>Client may want to be notified when the total number of audio output devices on the |
13529 |
|
back-end changes by issuing the following command: |
13530 |
|
</p> |
13531 |
|
<p> |
13532 |
|
</p> |
13533 |
|
<blockquote class="text"> |
13534 |
|
<p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT |
13535 |
|
</p> |
13536 |
|
</blockquote><p> |
13537 |
|
|
13538 |
|
</p> |
13539 |
|
<p>Server will start sending the following notification messages: |
13540 |
|
</p> |
13541 |
|
<p> |
13542 |
|
</p> |
13543 |
|
<blockquote class="text"> |
13544 |
|
<p>"NOTIFY:AUDIO_OUTPUT_DEVICE_COUNT:<devices>" |
13545 |
|
</p> |
13546 |
|
</blockquote><p> |
13547 |
|
|
13548 |
|
</p> |
13549 |
|
<p>where <devices> will be replaced by the new number |
13550 |
|
of audio output devices. |
13551 |
|
</p> |
13552 |
|
<a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO"></a><br /><hr /> |
13553 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13554 |
|
<a name="rfc.section.8.2"></a><h3>8.2. |
13555 |
|
Audio output device's settings changed</h3> |
13556 |
|
|
13557 |
|
<p>Client may want to be notified when changes were made to audio output devices on the |
13558 |
|
back-end by issuing the following command: |
13559 |
|
</p> |
13560 |
|
<p> |
13561 |
|
</p> |
13562 |
|
<blockquote class="text"> |
13563 |
|
<p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO |
13564 |
|
</p> |
13565 |
|
</blockquote><p> |
13566 |
|
|
13567 |
|
</p> |
13568 |
|
<p>Server will start sending the following notification messages: |
13569 |
|
</p> |
13570 |
|
<p> |
13571 |
|
</p> |
13572 |
|
<blockquote class="text"> |
13573 |
|
<p>"NOTIFY:AUDIO_OUTPUT_DEVICE_INFO:<device-id>" |
13574 |
|
</p> |
13575 |
|
</blockquote><p> |
13576 |
|
|
13577 |
|
</p> |
13578 |
|
<p>where <device-id> will be replaced by the numerical ID of the audio output device, |
13579 |
|
which settings has been changed. The front-end will have to send |
13580 |
|
the respective command to actually get the audio output device info. Because these messages |
13581 |
|
will be triggered by LSCP commands issued by other clients rather than real |
13582 |
|
time events happening on the server, it is believed that an empty notification |
13583 |
|
message is sufficient here. |
13584 |
|
</p> |
13585 |
|
<a name="SUBSCRIBE MIDI_INPUT_DEVICE_COUNT"></a><br /><hr /> |
13586 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13587 |
|
<a name="rfc.section.8.3"></a><h3>8.3. |
13588 |
|
Number of MIDI input devices changed</h3> |
13589 |
|
|
13590 |
|
<p>Client may want to be notified when the total number of MIDI input devices on the |
13591 |
|
back-end changes by issuing the following command: |
13592 |
|
</p> |
13593 |
|
<p> |
13594 |
|
</p> |
13595 |
|
<blockquote class="text"> |
13596 |
|
<p>SUBSCRIBE MIDI_INPUT_DEVICE_COUNT |
13597 |
|
</p> |
13598 |
|
</blockquote><p> |
13599 |
|
|
13600 |
|
</p> |
13601 |
|
<p>Server will start sending the following notification messages: |
13602 |
|
</p> |
13603 |
|
<p> |
13604 |
|
</p> |
13605 |
|
<blockquote class="text"> |
13606 |
|
<p>"NOTIFY:MIDI_INPUT_DEVICE_COUNT:<devices>" |
13607 |
|
</p> |
13608 |
|
</blockquote><p> |
13609 |
|
|
13610 |
|
</p> |
13611 |
|
<p>where <devices> will be replaced by the new number |
13612 |
|
of MIDI input devices. |
13613 |
|
</p> |
13614 |
|
<a name="SUBSCRIBE MIDI_INPUT_DEVICE_INFO"></a><br /><hr /> |
13615 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13616 |
|
<a name="rfc.section.8.4"></a><h3>8.4. |
13617 |
|
MIDI input device's settings changed</h3> |
13618 |
|
|
13619 |
|
<p>Client may want to be notified when changes were made to MIDI input devices on the |
13620 |
|
back-end by issuing the following command: |
13621 |
|
</p> |
13622 |
|
<p> |
13623 |
|
</p> |
13624 |
|
<blockquote class="text"> |
13625 |
|
<p>SUBSCRIBE MIDI_INPUT_DEVICE_INFO |
13626 |
|
</p> |
13627 |
|
</blockquote><p> |
13628 |
|
|
13629 |
|
</p> |
13630 |
|
<p>Server will start sending the following notification messages: |
13631 |
|
</p> |
13632 |
|
<p> |
13633 |
|
</p> |
13634 |
|
<blockquote class="text"> |
13635 |
|
<p>"NOTIFY:MIDI_INPUT_DEVICE_INFO:<device-id>" |
13636 |
|
</p> |
13637 |
|
</blockquote><p> |
13638 |
|
|
13639 |
|
</p> |
13640 |
|
<p>where <device-id> will be replaced by the numerical ID of the MIDI input device, |
13641 |
|
which settings has been changed. The front-end will have to send |
13642 |
|
the respective command to actually get the MIDI input device info. Because these messages |
13643 |
|
will be triggered by LSCP commands issued by other clients rather than real |
13644 |
|
time events happening on the server, it is believed that an empty notification |
13645 |
|
message is sufficient here. |
13646 |
|
</p> |
13647 |
|
<a name="SUBSCRIBE CHANNEL_COUNT"></a><br /><hr /> |
13648 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13649 |
|
<a name="rfc.section.8.5"></a><h3>8.5. |
13650 |
Number of sampler channels changed</h3> |
Number of sampler channels changed</h3> |
13651 |
|
|
13652 |
<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 |
13673 |
<p>where <channels> will be replaced by the new number |
<p>where <channels> will be replaced by the new number |
13674 |
of sampler channels. |
of sampler channels. |
13675 |
</p> |
</p> |
13676 |
|
<a name="SUBSCRIBE CHANNEL_MIDI"></a><br /><hr /> |
13677 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13678 |
|
<a name="rfc.section.8.6"></a><h3>8.6. |
13679 |
|
MIDI data on a sampler channel arrived</h3> |
13680 |
|
|
13681 |
|
<p>Client may want to be notified when MIDI data arrive on sampler channels on |
13682 |
|
back-end side, by issuing the following command: |
13683 |
|
</p> |
13684 |
|
<p> |
13685 |
|
</p> |
13686 |
|
<blockquote class="text"> |
13687 |
|
<p>SUBSCRIBE CHANNEL_MIDI |
13688 |
|
</p> |
13689 |
|
</blockquote><p> |
13690 |
|
|
13691 |
|
</p> |
13692 |
|
<p>Server will start sending one of the the following notification messages: |
13693 |
|
</p> |
13694 |
|
<p> |
13695 |
|
</p> |
13696 |
|
<blockquote class="text"> |
13697 |
|
<p>"NOTIFY:CHANNEL_MIDI:<channel-id> NOTE_ON <note> <velocity>" |
13698 |
|
</p> |
13699 |
|
<p>"NOTIFY:CHANNEL_MIDI:<channel-id> NOTE_OFF <note> <velocity>" |
13700 |
|
</p> |
13701 |
|
</blockquote><p> |
13702 |
|
|
13703 |
|
</p> |
13704 |
|
<p>where <channel-id> will be replaced by the ID of the sampler channel where the MIDI |
13705 |
|
data arrived. <note> and <velocity> are integer values in the range between |
13706 |
|
0 .. 127, reflecting the analog meaning of the MIDI specification. |
13707 |
|
|
13708 |
|
</p> |
13709 |
|
<p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all |
13710 |
|
delivered by this mechanism! With other words: events could be lost at any time! |
13711 |
|
This restriction was made to keep the RT-safeness of the backend's MIDI and audio |
13712 |
|
thread unaffected by this feature. |
13713 |
|
</p> |
13714 |
|
<a name="SUBSCRIBE DEVICE_MIDI"></a><br /><hr /> |
13715 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13716 |
|
<a name="rfc.section.8.7"></a><h3>8.7. |
13717 |
|
MIDI data on a MIDI input device arrived</h3> |
13718 |
|
|
13719 |
|
<p>Client may want to be notified when MIDI data arrive on MIDI input devices by issuing the following command: |
13720 |
|
</p> |
13721 |
|
<p> |
13722 |
|
</p> |
13723 |
|
<blockquote class="text"> |
13724 |
|
<p>SUBSCRIBE DEVICE_MIDI |
13725 |
|
</p> |
13726 |
|
</blockquote><p> |
13727 |
|
|
13728 |
|
</p> |
13729 |
|
<p>Server will start sending one of the the following notification messages: |
13730 |
|
</p> |
13731 |
|
<p> |
13732 |
|
</p> |
13733 |
|
<blockquote class="text"> |
13734 |
|
<p>"NOTIFY:DEVICE_MIDI:<device-id> <port-id> NOTE_ON <note> <velocity>" |
13735 |
|
</p> |
13736 |
|
<p>"NOTIFY:DEVICE_MIDI:<device-id> <port-id> NOTE_OFF <note> <velocity>" |
13737 |
|
</p> |
13738 |
|
</blockquote><p> |
13739 |
|
|
13740 |
|
</p> |
13741 |
|
<p>where <device-id> <port-id> will be replaced |
13742 |
|
by the IDs of the respective MIDI input device and the device's MIDI port where the MIDI |
13743 |
|
data arrived. <note> and <velocity> are integer values in the range between |
13744 |
|
0 .. 127, reflecting the analog meaning of the MIDI specification. |
13745 |
|
|
13746 |
|
</p> |
13747 |
|
<p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all |
13748 |
|
delivered by this mechanism! With other words: events could be lost at any time! |
13749 |
|
This restriction was made to keep the RT-safeness of the backend's MIDI and audio |
13750 |
|
thread unaffected by this feature. |
13751 |
|
</p> |
13752 |
<a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr /> |
<a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr /> |
13753 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13754 |
<a name="rfc.section.8.2"></a><h3>8.2. |
<a name="rfc.section.8.8"></a><h3>8.8. |
13755 |
Number of active voices changed</h3> |
Number of active voices changed</h3> |
13756 |
|
|
13757 |
<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 |
13770 |
<p> |
<p> |
13771 |
</p> |
</p> |
13772 |
<blockquote class="text"> |
<blockquote class="text"> |
13773 |
<p>"NOTIFY:VOICE_COUNT:<sampler-channel> <voices> |
<p>"NOTIFY:VOICE_COUNT:<sampler-channel> <voices>" |
13774 |
</p> |
</p> |
13775 |
</blockquote><p> |
</blockquote><p> |
13776 |
|
|
13781 |
</p> |
</p> |
13782 |
<a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr /> |
<a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr /> |
13783 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13784 |
<a name="rfc.section.8.3"></a><h3>8.3. |
<a name="rfc.section.8.9"></a><h3>8.9. |
13785 |
Number of active disk streams changed</h3> |
Number of active disk streams changed</h3> |
13786 |
|
|
13787 |
<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 |
13811 |
</p> |
</p> |
13812 |
<a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr /> |
<a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr /> |
13813 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13814 |
<a name="rfc.section.8.4"></a><h3>8.4. |
<a name="rfc.section.8.10"></a><h3>8.10. |
13815 |
Disk stream buffer fill state changed</h3> |
Disk stream buffer fill state changed</h3> |
13816 |
|
|
13817 |
<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 |
13840 |
buffer fill data for this channel as described in <a class='info' href='#GET CHANNEL BUFFER_FILL'>Section 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 6.4.13<span> (</span><span class='info'>Current fill state of disk stream buffers</span><span>)</span></a> |
13841 |
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. |
13842 |
</p> |
</p> |
13843 |
<a name="SUBSCRIBE INFO"></a><br /><hr /> |
<a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr /> |
13844 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13845 |
<a name="rfc.section.8.5"></a><h3>8.5. |
<a name="rfc.section.8.11"></a><h3>8.11. |
13846 |
Channel information changed</h3> |
Channel information changed</h3> |
13847 |
|
|
13848 |
<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 |
13873 |
time events happening on the server, it is believed that an empty notification |
time events happening on the server, it is believed that an empty notification |
13874 |
message is sufficient here. |
message is sufficient here. |
13875 |
</p> |
</p> |
13876 |
|
<a name="SUBSCRIBE FX_SEND_COUNT"></a><br /><hr /> |
13877 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13878 |
|
<a name="rfc.section.8.12"></a><h3>8.12. |
13879 |
|
Number of effect sends changed</h3> |
13880 |
|
|
13881 |
|
<p>Client may want to be notified when the number of effect sends on |
13882 |
|
a particular sampler channel is changed by issuing the following command: |
13883 |
|
</p> |
13884 |
|
<p> |
13885 |
|
</p> |
13886 |
|
<blockquote class="text"> |
13887 |
|
<p>SUBSCRIBE FX_SEND_COUNT |
13888 |
|
</p> |
13889 |
|
</blockquote><p> |
13890 |
|
|
13891 |
|
</p> |
13892 |
|
<p>Server will start sending the following notification messages: |
13893 |
|
</p> |
13894 |
|
<p> |
13895 |
|
</p> |
13896 |
|
<blockquote class="text"> |
13897 |
|
<p>"NOTIFY:FX_SEND_COUNT:<channel-id> <fx-sends>" |
13898 |
|
</p> |
13899 |
|
</blockquote><p> |
13900 |
|
|
13901 |
|
</p> |
13902 |
|
<p>where <channel-id> will be replaced by the numerical ID of the sampler |
13903 |
|
channel, on which the effect sends number is changed and <fx-sends> will |
13904 |
|
be replaced by the new number of effect sends on that channel. |
13905 |
|
</p> |
13906 |
|
<a name="SUBSCRIBE FX_SEND_INFO"></a><br /><hr /> |
13907 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13908 |
|
<a name="rfc.section.8.13"></a><h3>8.13. |
13909 |
|
Effect send information changed</h3> |
13910 |
|
|
13911 |
|
<p>Client may want to be notified when changes were made to effect sends on a |
13912 |
|
a particular sampler channel by issuing the following command: |
13913 |
|
</p> |
13914 |
|
<p> |
13915 |
|
</p> |
13916 |
|
<blockquote class="text"> |
13917 |
|
<p>SUBSCRIBE FX_SEND_INFO |
13918 |
|
</p> |
13919 |
|
</blockquote><p> |
13920 |
|
|
13921 |
|
</p> |
13922 |
|
<p>Server will start sending the following notification messages: |
13923 |
|
</p> |
13924 |
|
<p> |
13925 |
|
</p> |
13926 |
|
<blockquote class="text"> |
13927 |
|
<p>"NOTIFY:FX_SEND_INFO:<channel-id> <fx-send-id>" |
13928 |
|
</p> |
13929 |
|
</blockquote><p> |
13930 |
|
|
13931 |
|
</p> |
13932 |
|
<p>where <channel-id> will be replaced by the numerical ID of the sampler |
13933 |
|
channel, on which an effect send entity is changed and <fx-send-id> will |
13934 |
|
be replaced by the numerical ID of the changed effect send. |
13935 |
|
</p> |
13936 |
<a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr /> |
<a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr /> |
13937 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13938 |
<a name="rfc.section.8.6"></a><h3>8.6. |
<a name="rfc.section.8.14"></a><h3>8.14. |
13939 |
Total number of active voices changed</h3> |
Total number of active voices changed</h3> |
13940 |
|
|
13941 |
<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 |
13954 |
<p> |
<p> |
13955 |
</p> |
</p> |
13956 |
<blockquote class="text"> |
<blockquote class="text"> |
13957 |
<p>"NOTIFY:TOTAL_VOICE_COUNT:<voices> |
<p>"NOTIFY:TOTAL_VOICE_COUNT:<voices>" |
13958 |
</p> |
</p> |
13959 |
</blockquote><p> |
</blockquote><p> |
13960 |
|
|
13962 |
<p>where <voices> will be replaced by the new number of |
<p>where <voices> will be replaced by the new number of |
13963 |
all currently active voices. |
all currently active voices. |
13964 |
</p> |
</p> |
13965 |
|
<a name="SUBSCRIBE TOTAL_STREAM_COUNT"></a><br /><hr /> |
13966 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13967 |
|
<a name="rfc.section.8.15"></a><h3>8.15. |
13968 |
|
Total number of active disk streams changed</h3> |
13969 |
|
|
13970 |
|
<p>Client may want to be notified when the total number of disk streams on the |
13971 |
|
back-end changes by issuing the following command: |
13972 |
|
</p> |
13973 |
|
<p> |
13974 |
|
</p> |
13975 |
|
<blockquote class="text"> |
13976 |
|
<p>SUBSCRIBE TOTAL_STREAM_COUNT |
13977 |
|
</p> |
13978 |
|
</blockquote><p> |
13979 |
|
|
13980 |
|
</p> |
13981 |
|
<p>Server will start sending the following notification messages: |
13982 |
|
</p> |
13983 |
|
<p> |
13984 |
|
</p> |
13985 |
|
<blockquote class="text"> |
13986 |
|
<p>"NOTIFY:TOTAL_STREAM_COUNT:<streams>" |
13987 |
|
</p> |
13988 |
|
</blockquote><p> |
13989 |
|
|
13990 |
|
</p> |
13991 |
|
<p>where <streams> will be replaced by the new number of |
13992 |
|
all currently active disk streams. |
13993 |
|
</p> |
13994 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr /> |
13995 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
13996 |
|
<a name="rfc.section.8.16"></a><h3>8.16. |
13997 |
|
Number of MIDI instrument maps changed</h3> |
13998 |
|
|
13999 |
|
<p>Client may want to be notified when the number of MIDI instrument maps on the |
14000 |
|
back-end changes by issuing the following command: |
14001 |
|
</p> |
14002 |
|
<p> |
14003 |
|
</p> |
14004 |
|
<blockquote class="text"> |
14005 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT |
14006 |
|
</p> |
14007 |
|
</blockquote><p> |
14008 |
|
|
14009 |
|
</p> |
14010 |
|
<p>Server will start sending the following notification messages: |
14011 |
|
</p> |
14012 |
|
<p> |
14013 |
|
</p> |
14014 |
|
<blockquote class="text"> |
14015 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_MAP_COUNT:<maps>" |
14016 |
|
</p> |
14017 |
|
</blockquote><p> |
14018 |
|
|
14019 |
|
</p> |
14020 |
|
<p>where <maps> will be replaced by the new number |
14021 |
|
of MIDI instrument maps. |
14022 |
|
</p> |
14023 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr /> |
14024 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14025 |
|
<a name="rfc.section.8.17"></a><h3>8.17. |
14026 |
|
MIDI instrument map information changed</h3> |
14027 |
|
|
14028 |
|
<p>Client may want to be notified when changes were made to MIDI instrument maps on the |
14029 |
|
back-end by issuing the following command: |
14030 |
|
</p> |
14031 |
|
<p> |
14032 |
|
</p> |
14033 |
|
<blockquote class="text"> |
14034 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO |
14035 |
|
</p> |
14036 |
|
</blockquote><p> |
14037 |
|
|
14038 |
|
</p> |
14039 |
|
<p>Server will start sending the following notification messages: |
14040 |
|
</p> |
14041 |
|
<p> |
14042 |
|
</p> |
14043 |
|
<blockquote class="text"> |
14044 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_MAP_INFO:<map-id>" |
14045 |
|
</p> |
14046 |
|
</blockquote><p> |
14047 |
|
|
14048 |
|
</p> |
14049 |
|
<p>where <map-id> will be replaced by the numerical ID of the MIDI instrument map, |
14050 |
|
for which information changes occurred. The front-end will have to send |
14051 |
|
the respective command to actually get the MIDI instrument map info. Because these messages |
14052 |
|
will be triggered by LSCP commands issued by other clients rather than real |
14053 |
|
time events happening on the server, it is believed that an empty notification |
14054 |
|
message is sufficient here. |
14055 |
|
</p> |
14056 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr /> |
14057 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14058 |
|
<a name="rfc.section.8.18"></a><h3>8.18. |
14059 |
|
Number of MIDI instruments changed</h3> |
14060 |
|
|
14061 |
|
<p>Client may want to be notified when the number of MIDI instrument maps on the |
14062 |
|
back-end changes by issuing the following command: |
14063 |
|
</p> |
14064 |
|
<p> |
14065 |
|
</p> |
14066 |
|
<blockquote class="text"> |
14067 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_COUNT |
14068 |
|
</p> |
14069 |
|
</blockquote><p> |
14070 |
|
|
14071 |
|
</p> |
14072 |
|
<p>Server will start sending the following notification messages: |
14073 |
|
</p> |
14074 |
|
<p> |
14075 |
|
</p> |
14076 |
|
<blockquote class="text"> |
14077 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_COUNT:<map-id> <instruments>" |
14078 |
|
</p> |
14079 |
|
</blockquote><p> |
14080 |
|
|
14081 |
|
</p> |
14082 |
|
<p>where <map-id> is the numerical ID of the MIDI instrument map, in which |
14083 |
|
the nuber of instruments has changed and <instruments> will be replaced by |
14084 |
|
the new number of MIDI instruments in the specified map. |
14085 |
|
</p> |
14086 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr /> |
14087 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14088 |
|
<a name="rfc.section.8.19"></a><h3>8.19. |
14089 |
|
MIDI instrument information changed</h3> |
14090 |
|
|
14091 |
|
<p>Client may want to be notified when changes were made to MIDI instruments on the |
14092 |
|
back-end by issuing the following command: |
14093 |
|
</p> |
14094 |
|
<p> |
14095 |
|
</p> |
14096 |
|
<blockquote class="text"> |
14097 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_INFO |
14098 |
|
</p> |
14099 |
|
</blockquote><p> |
14100 |
|
|
14101 |
|
</p> |
14102 |
|
<p>Server will start sending the following notification messages: |
14103 |
|
</p> |
14104 |
|
<p> |
14105 |
|
</p> |
14106 |
|
<blockquote class="text"> |
14107 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_INFO:<map-id> <bank> <program>" |
14108 |
|
</p> |
14109 |
|
</blockquote><p> |
14110 |
|
|
14111 |
|
</p> |
14112 |
|
<p>where <map-id> will be replaced by the numerical ID of the MIDI instrument map, |
14113 |
|
in which a MIDI instrument is changed. <bank> and <program> specifies |
14114 |
|
the location of the changed MIDI instrument in the map. The front-end will have to send |
14115 |
|
the respective command to actually get the MIDI instrument info. Because these messages |
14116 |
|
will be triggered by LSCP commands issued by other clients rather than real |
14117 |
|
time events happening on the server, it is believed that an empty notification |
14118 |
|
message is sufficient here. |
14119 |
|
</p> |
14120 |
|
<a name="SUBSCRIBE GLOBAL_INFO"></a><br /><hr /> |
14121 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14122 |
|
<a name="rfc.section.8.20"></a><h3>8.20. |
14123 |
|
Global settings changed</h3> |
14124 |
|
|
14125 |
|
<p>Client may want to be notified when changes to the global settings |
14126 |
|
of the sampler were made by issuing the following command: |
14127 |
|
</p> |
14128 |
|
<p> |
14129 |
|
</p> |
14130 |
|
<blockquote class="text"> |
14131 |
|
<p>SUBSCRIBE GLOBAL_INFO |
14132 |
|
</p> |
14133 |
|
</blockquote><p> |
14134 |
|
|
14135 |
|
</p> |
14136 |
|
<p>Server will start sending the following types of notification messages: |
14137 |
|
</p> |
14138 |
|
<p> |
14139 |
|
</p> |
14140 |
|
<blockquote class="text"> |
14141 |
|
<p>"NOTIFY:GLOBAL_INFO:VOLUME <volume>" - Notifies that the |
14142 |
|
golbal volume of the sampler is changed, where <volume> will be |
14143 |
|
replaced by the optional dotted floating point value, reflecting the |
14144 |
|
new global volume parameter. |
14145 |
|
</p> |
14146 |
|
</blockquote><p> |
14147 |
|
</p> |
14148 |
|
<blockquote class="text"> |
14149 |
|
<p>"NOTIFY:GLOBAL_INFO:VOICES <max-voices>" - Notifies that the |
14150 |
|
golbal limit of the sampler for maximum voices is changed, where |
14151 |
|
<max-voices> will be an integer value, reflecting the |
14152 |
|
new global voice limit parameter. |
14153 |
|
</p> |
14154 |
|
</blockquote><p> |
14155 |
|
</p> |
14156 |
|
<blockquote class="text"> |
14157 |
|
<p>"NOTIFY:GLOBAL_INFO:STREAMS <max-streams>" - Notifies that the |
14158 |
|
golbal limit of the sampler for maximum disk streams is changed, where |
14159 |
|
<max-streams> will be an integer value, reflecting the |
14160 |
|
new global disk streams limit parameter. |
14161 |
|
</p> |
14162 |
|
</blockquote><p> |
14163 |
|
|
14164 |
|
</p> |
14165 |
|
<a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT"></a><br /><hr /> |
14166 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14167 |
|
<a name="rfc.section.8.21"></a><h3>8.21. |
14168 |
|
Number of database instrument directories changed</h3> |
14169 |
|
|
14170 |
|
<p>Client may want to be notified when the number of instrument |
14171 |
|
directories in a particular directory in the instruments database |
14172 |
|
is changed by issuing the following command: |
14173 |
|
</p> |
14174 |
|
<p> |
14175 |
|
</p> |
14176 |
|
<blockquote class="text"> |
14177 |
|
<p>SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT |
14178 |
|
</p> |
14179 |
|
</blockquote><p> |
14180 |
|
|
14181 |
|
</p> |
14182 |
|
<p>Server will start sending the following notification messages: |
14183 |
|
</p> |
14184 |
|
<p> |
14185 |
|
</p> |
14186 |
|
<blockquote class="text"> |
14187 |
|
<p>"NOTIFY:DB_INSTRUMENT_DIRECTORY_COUNT:<dir-path>" |
14188 |
|
</p> |
14189 |
|
</blockquote><p> |
14190 |
|
|
14191 |
|
</p> |
14192 |
|
<p>where <dir-path> will be replaced by the absolute path |
14193 |
|
name of the directory in the instruments database, |
14194 |
|
in which the number of directories is changed. |
14195 |
|
</p> |
14196 |
|
<p>Note that when a non-empty directory is removed, this event |
14197 |
|
is not sent for the subdirectories in that directory. |
14198 |
|
</p> |
14199 |
|
<a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO"></a><br /><hr /> |
14200 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14201 |
|
<a name="rfc.section.8.22"></a><h3>8.22. |
14202 |
|
Database instrument directory information changed</h3> |
14203 |
|
|
14204 |
|
<p>Client may want to be notified when changes were made to directories |
14205 |
|
in the instruments database by issuing the following command: |
14206 |
|
</p> |
14207 |
|
<p> |
14208 |
|
</p> |
14209 |
|
<blockquote class="text"> |
14210 |
|
<p>SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO |
14211 |
|
</p> |
14212 |
|
</blockquote><p> |
14213 |
|
|
14214 |
|
</p> |
14215 |
|
<p>Server will start sending the following notification messages: |
14216 |
|
</p> |
14217 |
|
<p> |
14218 |
|
</p> |
14219 |
|
<blockquote class="text"> |
14220 |
|
<p>"NOTIFY:DB_INSTRUMENT_DIRECTORY_INFO:<dir-path>" |
14221 |
|
</p> |
14222 |
|
</blockquote><p> |
14223 |
|
|
14224 |
|
</p> |
14225 |
|
<p>where <dir-path> will be replaced by the absolute path name |
14226 |
|
of the directory, for which information changes occurred. The front-end will have to send |
14227 |
|
the respective command to actually get the updated directory info. Because these messages |
14228 |
|
will be triggered by LSCP commands issued by other clients rather than real |
14229 |
|
time events happening on the server, it is believed that an empty notification |
14230 |
|
message is sufficient here. |
14231 |
|
</p> |
14232 |
|
<p> |
14233 |
|
</p> |
14234 |
|
<blockquote class="text"> |
14235 |
|
<p>"NOTIFY:DB_INSTRUMENT_DIRECTORY_INFO:NAME <old-dir-path> <new-name>" |
14236 |
|
</p> |
14237 |
|
</blockquote><p> |
14238 |
|
|
14239 |
|
</p> |
14240 |
|
<p>where <old-dir-path> is the old absolute path name of the directory |
14241 |
|
(encapsulated into apostrophes), which name is changes and <new-name> is |
14242 |
|
the new name of the directory, encapsulated into apostrophes. |
14243 |
|
</p> |
14244 |
|
<a name="SUBSCRIBE DB_INSTRUMENT_COUNT"></a><br /><hr /> |
14245 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14246 |
|
<a name="rfc.section.8.23"></a><h3>8.23. |
14247 |
|
Number of database instruments changed</h3> |
14248 |
|
|
14249 |
|
<p>Client may want to be notified when the number of instruments |
14250 |
|
in a particular directory in the instruments database |
14251 |
|
is changed by issuing the following command: |
14252 |
|
</p> |
14253 |
|
<p> |
14254 |
|
</p> |
14255 |
|
<blockquote class="text"> |
14256 |
|
<p>SUBSCRIBE DB_INSTRUMENT_COUNT |
14257 |
|
</p> |
14258 |
|
</blockquote><p> |
14259 |
|
|
14260 |
|
</p> |
14261 |
|
<p>Server will start sending the following notification messages: |
14262 |
|
</p> |
14263 |
|
<p> |
14264 |
|
</p> |
14265 |
|
<blockquote class="text"> |
14266 |
|
<p>"NOTIFY:DB_INSTRUMENT_COUNT:<dir-path>" |
14267 |
|
</p> |
14268 |
|
</blockquote><p> |
14269 |
|
|
14270 |
|
</p> |
14271 |
|
<p>where <dir-path> will be replaced by the absolute path |
14272 |
|
name of the directory in the instruments database, |
14273 |
|
in which the number of instruments is changed. |
14274 |
|
</p> |
14275 |
|
<p>Note that when a non-empty directory is removed, this event |
14276 |
|
is not sent for the instruments in that directory. |
14277 |
|
</p> |
14278 |
|
<a name="SUBSCRIBE DB_INSTRUMENT_INFO"></a><br /><hr /> |
14279 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14280 |
|
<a name="rfc.section.8.24"></a><h3>8.24. |
14281 |
|
Database instrument information changed</h3> |
14282 |
|
|
14283 |
|
<p>Client may want to be notified when changes were made to instruments |
14284 |
|
in the instruments database by issuing the following command: |
14285 |
|
</p> |
14286 |
|
<p> |
14287 |
|
</p> |
14288 |
|
<blockquote class="text"> |
14289 |
|
<p>SUBSCRIBE DB_INSTRUMENT_INFO |
14290 |
|
</p> |
14291 |
|
</blockquote><p> |
14292 |
|
|
14293 |
|
</p> |
14294 |
|
<p>Server will start sending the following notification messages: |
14295 |
|
</p> |
14296 |
|
<p> |
14297 |
|
</p> |
14298 |
|
<blockquote class="text"> |
14299 |
|
<p>"NOTIFY:DB_INSTRUMENT_INFO:<instr-path>" |
14300 |
|
</p> |
14301 |
|
</blockquote><p> |
14302 |
|
|
14303 |
|
</p> |
14304 |
|
<p>where <instr-path> will be replaced by the absolute path name |
14305 |
|
of the instrument, which settings are changed. The front-end will have to send |
14306 |
|
the respective command to actually get the updated directory info. Because these messages |
14307 |
|
will be triggered by LSCP commands issued by other clients rather than real |
14308 |
|
time events happening on the server, it is believed that an empty notification |
14309 |
|
message is sufficient here. |
14310 |
|
</p> |
14311 |
|
<p> |
14312 |
|
</p> |
14313 |
|
<blockquote class="text"> |
14314 |
|
<p>"NOTIFY:DB_INSTRUMENT_INFO:NAME <old-instr-path> <new-name>" |
14315 |
|
</p> |
14316 |
|
</blockquote><p> |
14317 |
|
|
14318 |
|
</p> |
14319 |
|
<p>where <old-instr-path> is the old absolute path name of the instrument |
14320 |
|
(encapsulated into apostrophes), which name is changes and <new-name> is |
14321 |
|
the new name of the instrument, encapsulated into apostrophes. |
14322 |
|
</p> |
14323 |
|
<a name="SUBSCRIBE DB_INSTRUMENTS_JOB_INFO"></a><br /><hr /> |
14324 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14325 |
|
<a name="rfc.section.8.25"></a><h3>8.25. |
14326 |
|
Database job status information changed</h3> |
14327 |
|
|
14328 |
|
<p>Client may want to be notified when the status of particular database |
14329 |
|
instruments job is changed by issuing the following command: |
14330 |
|
</p> |
14331 |
|
<p> |
14332 |
|
</p> |
14333 |
|
<blockquote class="text"> |
14334 |
|
<p>SUBSCRIBE DB_INSTRUMENTS_JOB_INFO |
14335 |
|
</p> |
14336 |
|
</blockquote><p> |
14337 |
|
|
14338 |
|
</p> |
14339 |
|
<p>Server will start sending the following notification messages: |
14340 |
|
</p> |
14341 |
|
<p> |
14342 |
|
</p> |
14343 |
|
<blockquote class="text"> |
14344 |
|
<p>"NOTIFY:DB_INSTRUMENTS_JOB_INFO:<job-id>" |
14345 |
|
</p> |
14346 |
|
</blockquote><p> |
14347 |
|
|
14348 |
|
</p> |
14349 |
|
<p>where <job-id> will be replaced by the numerical ID of the job, |
14350 |
|
which status is changed. The front-end will have to send the respective |
14351 |
|
command to actually get the status info. Because these messages |
14352 |
|
will be triggered by LSCP commands issued by other clients rather than real |
14353 |
|
time events happening on the server, it is believed that an empty notification |
14354 |
|
message is sufficient here. |
14355 |
|
</p> |
14356 |
|
<a name="SUBSCRIBE EFFECT_INSTANCE_COUNT"></a><br /><hr /> |
14357 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14358 |
|
<a name="rfc.section.8.26"></a><h3>8.26. |
14359 |
|
Number of effect instances changed</h3> |
14360 |
|
|
14361 |
|
<p>Client may want to be notified when the number of effect instances |
14362 |
|
is changed by issuing the following command: |
14363 |
|
</p> |
14364 |
|
<p> |
14365 |
|
</p> |
14366 |
|
<blockquote class="text"> |
14367 |
|
<p>SUBSCRIBE EFFECT_INSTANCE_COUNT |
14368 |
|
</p> |
14369 |
|
</blockquote><p> |
14370 |
|
|
14371 |
|
</p> |
14372 |
|
<p>Server will start sending the following notification messages: |
14373 |
|
</p> |
14374 |
|
<p> |
14375 |
|
</p> |
14376 |
|
<blockquote class="text"> |
14377 |
|
<p>"EFFECT_INSTANCE_COUNT:<instances>" |
14378 |
|
</p> |
14379 |
|
</blockquote><p> |
14380 |
|
|
14381 |
|
</p> |
14382 |
|
<p>where <instances> will be replaced by the new number |
14383 |
|
of effect instances. |
14384 |
|
</p> |
14385 |
|
<a name="SUBSCRIBE EFFECT_INSTANCE_INFO"></a><br /><hr /> |
14386 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14387 |
|
<a name="rfc.section.8.27"></a><h3>8.27. |
14388 |
|
Effect instance information changed</h3> |
14389 |
|
|
14390 |
|
<p>Client may want to be notified when changes were made to effect instances |
14391 |
|
on the back-end by issuing the following command: |
14392 |
|
</p> |
14393 |
|
<p> |
14394 |
|
</p> |
14395 |
|
<blockquote class="text"> |
14396 |
|
<p>SUBSCRIBE EFFECT_INSTANCE_INFO |
14397 |
|
</p> |
14398 |
|
</blockquote><p> |
14399 |
|
|
14400 |
|
</p> |
14401 |
|
<p>Server will start sending the following notification messages: |
14402 |
|
</p> |
14403 |
|
<p> |
14404 |
|
</p> |
14405 |
|
<blockquote class="text"> |
14406 |
|
<p>"EFFECT_INSTANCE_INFO:<instance-id>" |
14407 |
|
</p> |
14408 |
|
</blockquote><p> |
14409 |
|
|
14410 |
|
</p> |
14411 |
|
<p>where <instance-id> will be replaced by the numerical ID |
14412 |
|
of the effect instance. |
14413 |
|
</p> |
14414 |
|
<a name="SUBSCRIBE SEND_EFFECT_CHAIN_COUNT"></a><br /><hr /> |
14415 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14416 |
|
<a name="rfc.section.8.28"></a><h3>8.28. |
14417 |
|
Number of send effect chains changed</h3> |
14418 |
|
|
14419 |
|
<p>Client may want to be notified when the number of send effect chains |
14420 |
|
is changed by issuing the following command: |
14421 |
|
</p> |
14422 |
|
<p> |
14423 |
|
</p> |
14424 |
|
<blockquote class="text"> |
14425 |
|
<p>SUBSCRIBE SEND_EFFECT_CHAIN_COUNT |
14426 |
|
</p> |
14427 |
|
</blockquote><p> |
14428 |
|
|
14429 |
|
</p> |
14430 |
|
<p>Server will start sending the following notification messages: |
14431 |
|
</p> |
14432 |
|
<p> |
14433 |
|
</p> |
14434 |
|
<blockquote class="text"> |
14435 |
|
<p>"NOTIFY:SEND_EFFECT_CHAIN_COUNT:<device-id> <chains>" |
14436 |
|
</p> |
14437 |
|
</blockquote><p> |
14438 |
|
|
14439 |
|
</p> |
14440 |
|
<p>where <device-id> will be replaced by the numerical ID of the audio |
14441 |
|
output device, in which the number of send effect chains is changed and |
14442 |
|
<chains> will be replaced by the new number of send effect chains. |
14443 |
|
</p> |
14444 |
|
<a name="SUBSCRIBE SEND_EFFECT_CHAIN_INFO"></a><br /><hr /> |
14445 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14446 |
|
<a name="rfc.section.8.29"></a><h3>8.29. |
14447 |
|
Send effect chain information changed</h3> |
14448 |
|
|
14449 |
|
<p>Client may want to be notified when changes were made to send effect chains |
14450 |
|
on the back-end by issuing the following command: |
14451 |
|
</p> |
14452 |
|
<p> |
14453 |
|
</p> |
14454 |
|
<blockquote class="text"> |
14455 |
|
<p>SUBSCRIBE SEND_EFFECT_CHAIN_INFO |
14456 |
|
</p> |
14457 |
|
</blockquote><p> |
14458 |
|
|
14459 |
|
</p> |
14460 |
|
<p>Server will start sending the following notification messages: |
14461 |
|
</p> |
14462 |
|
<p> |
14463 |
|
</p> |
14464 |
|
<blockquote class="text"> |
14465 |
|
<p>"SEND_EFFECT_CHAIN_INFO:<device-id> <chain-id> <instances>" - |
14466 |
|
Notifies that the number of effect instances in a particular send effect chain |
14467 |
|
is changed, where <device-id> will be replaced by the numerical ID of the audio |
14468 |
|
output device the send effect chain belongs to, <chain-id> will be replaced |
14469 |
|
by the numerical ID of the send effect chain in which the number of effect instances |
14470 |
|
has changed and <instances> will be replaced by the new number |
14471 |
|
of effect instances in the specified send effect chain. |
14472 |
|
</p> |
14473 |
|
</blockquote><p> |
14474 |
|
|
14475 |
|
</p> |
14476 |
<a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr /> |
<a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr /> |
14477 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14478 |
<a name="rfc.section.8.7"></a><h3>8.7. |
<a name="rfc.section.8.30"></a><h3>8.30. |
14479 |
Miscellaneous and debugging events</h3> |
Miscellaneous and debugging events</h3> |
14480 |
|
|
14481 |
<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 |
14540 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14541 |
<h3>11. References</h3> |
<h3>11. References</h3> |
14542 |
<table width="99%" border="0"> |
<table width="99%" border="0"> |
14543 |
|
<tr><td class="author-text" valign="top"><a name="RFC20">[RFC20]</a></td> |
14544 |
|
<td class="author-text">UCLA, “<a href="http://tools.ietf.org/html/rfc20">ASCII format for Network Interchange</a>,” RFC 20, 1969.</td></tr> |
14545 |
<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> |
14546 |
<td class="author-text">Bradner, S., “<a href="ftp://ftp.isi.edu/in-notes/rfc2119.txt">Key words for use in RFCs to Indicate Requirement Levels</a>,” RFC 2119, 1997.</td></tr> |
<td class="author-text">Bradner, S., “<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>,” RFC 2119, 1997.</td></tr> |
14547 |
<tr><td class="author-text" valign="top"><a name="RFC2234">[RFC2234]</a></td> |
<tr><td class="author-text" valign="top"><a name="RFC2234">[RFC2234]</a></td> |
14548 |
<td class="author-text">Crocker, D. and P. Overell, “<a href="ftp://ftp.isi.edu/in-notes/rfc2234.txt">Augmented BNF for Syntax Specifications</a>,” RFC 2234, 1997.</td></tr> |
<td class="author-text">Crocker, D. and P. Overell, “<a href="http://tools.ietf.org/html/rfc2234">Augmented BNF for Syntax Specifications</a>,” RFC 2234, 1997.</td></tr> |
14549 |
<tr><td class="author-text" valign="top"><a name="RFC793">[RFC793]</a></td> |
<tr><td class="author-text" valign="top"><a name="RFC793">[RFC793]</a></td> |
14550 |
<td class="author-text">Defense Advanced Research Projects Agency, “<a href="ftp://ftp.isi.edu/in-notes/rfc793.txt">TRANSMISSION CONTROL PROTOCOL</a>,” RFC 793, 1981.</td></tr> |
<td class="author-text">Defense Advanced Research Projects Agency, “<a href="http://tools.ietf.org/html/rfc793">TRANSMISSION CONTROL PROTOCOL</a>,” RFC 793, 1981.</td></tr> |
14551 |
</table> |
</table> |
14552 |
|
|
14553 |
<a name="rfc.authors"></a><br /><hr /> |
<a name="rfc.authors"></a><br /><hr /> |
14558 |
<td class="author-text">C. |
<td class="author-text">C. |
14559 |
Schoenebeck</td></tr> |
Schoenebeck</td></tr> |
14560 |
<tr><td class="author-text"> </td> |
<tr><td class="author-text"> </td> |
14561 |
<td class="author-text">Interessengemeinschaft Software Engineering e. V.</td></tr> |
<td class="author-text">LinuxSampler.org</td></tr> |
14562 |
<tr><td class="author-text"> </td> |
<tr><td class="author-text"> </td> |
14563 |
<td class="author-text">Max-Planck-Str. 39</td></tr> |
<td class="author-text">Crudebyte Engineering</td></tr> |
14564 |
<tr><td class="author-text"> </td> |
<tr><td class="author-text"> </td> |
14565 |
<td class="author-text">74081 Heilbronn</td></tr> |
<td class="author-text">Hofgartenstr. 3</td></tr> |
14566 |
|
<tr><td class="author-text"> </td> |
14567 |
|
<td class="author-text">74189 Weinsberg</td></tr> |
14568 |
<tr><td class="author-text"> </td> |
<tr><td class="author-text"> </td> |
14569 |
<td class="author-text">Germany</td></tr> |
<td class="author-text">Germany</td></tr> |
14570 |
|
<tr><td class="author" align="right">Phone: </td> |
14571 |
|
<td class="author-text">+49 7134 911614</td></tr> |
14572 |
<tr><td class="author" align="right">Email: </td> |
<tr><td class="author" align="right">Email: </td> |
14573 |
<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:cuse@users.sf.net">cuse@users.sf.net</a></td></tr> |
14574 |
</table> |
</table> |
14575 |
<a name="rfc.copyright"></a><br /><hr /> |
<a name="rfc.copyright"></a><br /><hr /> |
14576 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
14577 |
<h3>Full Copyright Statement</h3> |
<h3>Full Copyright Statement</h3> |
14578 |
<p class='copyright'> |
<p class='copyright'> |
14579 |
Copyright © The Internet Society (2006).</p> |
Copyright © The IETF Trust (2014).</p> |
14580 |
<p class='copyright'> |
<p class='copyright'> |
14581 |
This document is subject to the rights, |
This document is subject to the rights, |
14582 |
licenses and restrictions contained in BCP 78, |
licenses and restrictions contained in BCP 78, |
14585 |
<p class='copyright'> |
<p class='copyright'> |
14586 |
This document and the information contained herein are provided |
This document and the information contained herein are provided |
14587 |
on an “AS IS” basis and THE CONTRIBUTOR, |
on an “AS IS” basis and THE CONTRIBUTOR, |
14588 |
THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), |
THE ORGANIZATION HE/SHE REPRESENTS |
14589 |
THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM |
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST |
14590 |
ALL WARRANTIES, |
AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, |
14591 |
EXPRESS OR IMPLIED, |
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT |
14592 |
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE |
THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY |
14593 |
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED |
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR |
14594 |
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p> |
PURPOSE.</p> |
14595 |
<h3>Intellectual Property</h3> |
<h3>Intellectual Property</h3> |
14596 |
<p class='copyright'> |
<p class='copyright'> |
14597 |
The IETF takes no position regarding the validity or scope of any |
The IETF takes no position regarding the validity or scope of any |
14618 |
proprietary rights that may cover technology that may be required |
proprietary rights that may cover technology that may be required |
14619 |
to implement this standard. |
to implement this standard. |
14620 |
Please address the information to the IETF at <a href='mailto:ietf-ipr@ietf.org'>ietf-ipr@ietf.org</a>.</p> |
Please address the information to the IETF at <a href='mailto:ietf-ipr@ietf.org'>ietf-ipr@ietf.org</a>.</p> |
|
<h3>Acknowledgment</h3> |
|
|
<p class='copyright'> |
|
|
Funding for the RFC Editor function is provided by |
|
|
the IETF Administrative Support Activity (IASA).</p> |
|
14621 |
</body></html> |
</body></html> |