/[svn]/web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html
ViewVC logotype

Diff of /web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1028 by schoenebeck, Sun Jan 14 17:33:03 2007 UTC revision 1048 by schoenebeck, Mon Feb 19 19:46:20 2007 UTC
# Line 145  Line 145 
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    
# Line 173  The list of current Internet-Drafts can Line 173  The list of current Internet-Drafts can
173  The list of Internet-Draft Shadow Directories can be accessed at  The list of Internet-Draft Shadow Directories can be accessed at
174  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>
175  <p>  <p>
176  This Internet-Draft will expire on 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>
# Line 6488  Create or replace a MIDI instrument map Line 6488  Create or replace a MIDI instrument map
6488  <p>  <p>
6489                          </p>                          </p>
6490  <blockquote class="text">  <blockquote class="text">
6491  <p>MAP MIDI_INSTRUMENT &lt;map&gt;  <p>MAP MIDI_INSTRUMENT [NON_MODAL] &lt;map&gt;
6492                              &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;                              &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;
6493                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;
6494                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]
# Line 6552  Create or replace a MIDI instrument map Line 6552  Create or replace a MIDI instrument map
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
# Line 6609  Create or replace a MIDI instrument map Line 6609  Create or replace a MIDI instrument map
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:
# Line 6682  Create or replace a MIDI instrument map Line 6688  Create or replace a MIDI instrument map
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>
# Line 7318  Command Syntax</h3> Line 7324  Command Syntax</h3>
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>
# Line 7622  Command Syntax</h3> Line 7628  Command Syntax</h3>
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 =

Legend:
Removed from v.1028  
changed lines
  Added in v.1048

  ViewVC Help
Powered by ViewVC