145 |
<tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr> |
<tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr> |
146 |
<tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr> |
<tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr> |
147 |
<tr><td class="header">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">Engineering e. V.</td></tr> |
148 |
<tr><td class="header">Expires: July 18, 2007</td><td class="header">January 14, 2007</td></tr> |
<tr><td class="header">Expires: August 23, 2007</td><td class="header">February 19, 2007</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.2</h1> |
151 |
|
|
173 |
The list of Internet-Draft Shadow Directories can be accessed at |
The list of Internet-Draft Shadow Directories can be accessed at |
174 |
<a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p> |
<a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p> |
175 |
<p> |
<p> |
176 |
This Internet-Draft will expire on July 18, 2007.</p> |
This Internet-Draft will expire on August 23, 2007.</p> |
177 |
|
|
178 |
<h3>Copyright Notice</h3> |
<h3>Copyright Notice</h3> |
179 |
<p> |
<p> |
6488 |
<p> |
<p> |
6489 |
</p> |
</p> |
6490 |
<blockquote class="text"> |
<blockquote class="text"> |
6491 |
<p>MAP MIDI_INSTRUMENT <map> |
<p>MAP MIDI_INSTRUMENT [NON_MODAL] <map> |
6492 |
<midi_bank> <midi_prog> <engine_name> |
<midi_bank> <midi_prog> <engine_name> |
6493 |
<filename> <instrument_index> <volume_value> |
<filename> <instrument_index> <volume_value> |
6494 |
[<instr_load_mode>] [<name>] |
[<instr_load_mode>] [<name>] |
6552 |
</p> |
</p> |
6553 |
<blockquote class="text"> |
<blockquote class="text"> |
6554 |
<p>The instrument will immediately be loaded |
<p>The instrument will immediately be loaded |
6555 |
into memory in the background when this mapping |
into memory when this mapping |
6556 |
command is sent and the instrument is kept all |
command is sent and the instrument is kept all |
6557 |
the time. Instruments with this mode are |
the time. Instruments with this mode are |
6558 |
only freed when the sampler is reset or all |
only freed when the sampler is reset or all |
6609 |
|
|
6610 |
</p> |
</p> |
6611 |
<p> |
<p> |
6612 |
The "MAP MIDI_INSTRUMENT" command |
By default, "MAP MIDI_INSTRUMENT" commands block until the mapping is |
6613 |
will immediately return, thus it will not block when an |
completely established in the sampler. The OPTIONAL "NON_MODAL" argument |
6614 |
instrument is to be loaded due to a "PERSISTENT" type |
however causes the respective "MAP MIDI_INSTRUMENT" command to return |
6615 |
entry as instruments are loaded in the background. As a |
immediately, that is to let the sampler establish the mapping in the |
6616 |
consequence this command may not necessarily return an error |
background. So this argument might be especially useful for mappings with |
6617 |
i.e. when the given instrument file does not exist or may |
a "PERSISTENT" type, because these have to load the respective instruments |
6618 |
turn out to be corrupt. |
immediately and might thus block for a very long time. It is recommended |
6619 |
|
however to use the OPTIONAL "NON_MODAL" argument only if really necessary, |
6620 |
|
because it has the following drawbacks: as "NON_MODAL" instructions return |
6621 |
|
immediately, they may not necessarily return an error i.e. when the given |
6622 |
|
instrument file turns out to be corrupt, beside that subsequent commands |
6623 |
|
in a LSCP instruction sequence might fail, because mandatory mappings are |
6624 |
|
not yet completed. |
6625 |
|
|
6626 |
</p> |
</p> |
6627 |
<p>Possible Answers: |
<p>Possible Answers: |
6688 |
<p> |
<p> |
6689 |
</p> |
</p> |
6690 |
<blockquote class="text"> |
<blockquote class="text"> |
6691 |
<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'" |
6692 |
</p> |
</p> |
6693 |
<p>S: "OK" |
<p>S: "OK" |
6694 |
</p> |
</p> |
7324 |
<p>map_instruction = |
<p>map_instruction = |
7325 |
</p> |
</p> |
7326 |
<blockquote class="text"> |
<blockquote class="text"> |
7327 |
<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 |
7328 |
|
|
7329 |
</p> |
</p> |
7330 |
<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 |
7331 |
|
|
7332 |
</p> |
</p> |
7333 |
<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 |
7334 |
|
|
7335 |
</p> |
</p> |
7336 |
<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 |
7337 |
|
|
7338 |
</p> |
</p> |
7339 |
</blockquote><p> |
</blockquote><p> |
7628 |
|
|
7629 |
</p> |
</p> |
7630 |
</blockquote><p> |
</blockquote><p> |
7631 |
|
|
7632 |
|
</p> |
7633 |
|
<p>modal_arg = |
7634 |
|
</p> |
7635 |
|
<blockquote class="text"> |
7636 |
|
<p>/* epsilon (empty argument) */ |
7637 |
|
|
7638 |
|
</p> |
7639 |
|
<p>/ NON_MODAL SP |
7640 |
|
|
7641 |
|
</p> |
7642 |
|
</blockquote><p> |
7643 |
|
|
7644 |
</p> |
</p> |
7645 |
<p>key_val_list = |
<p>key_val_list = |