/[svn]/linuxsampler/trunk/Documentation/lscp.xml
ViewVC logotype

Diff of /linuxsampler/trunk/Documentation/lscp.xml

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

revision 1391 by iliev, Sun Oct 7 19:50:28 2007 UTC revision 1541 by iliev, Tue Dec 4 18:09:26 2007 UTC
# Line 16  Line 16 
16       to an annoying "missing Normative/Informative References" error message -->       to an annoying "missing Normative/Informative References" error message -->
17  <?rfc strict="no" ?>  <?rfc strict="no" ?>
18    
19  <rfc category="std" ipr="full3978" docName="LSCP 1.2cvs">  <rfc category="std" ipr="full3978" docName="LSCP 1.2">
20      <front>      <front>
21          <title>LinuxSampler Control Protocol (draft)</title>          <title>LinuxSampler Control Protocol</title>
22          <author initials='C.S.' surname="Schoenebeck" fullname='C.          <author initials='C.S.' surname="Schoenebeck" fullname='C.
23  Schoenebeck'>  Schoenebeck'>
24              <organization>              <organization>
# Line 2443  Schoenebeck'> Line 2443  Schoenebeck'>
2443                                  <list>                                  <list>
2444                                      <t>DESCRIPTION -                                      <t>DESCRIPTION -
2445                                          <list>                                          <list>
2446                                              <t>arbitrary description text about the engine</t>                                              <t>arbitrary description text about the engine
2447                                                (note that the character string may contain
2448                                                <xref target="character_set">escape sequences</xref>)</t>
2449                                          </list>                                          </list>
2450                                      </t>                                      </t>
2451                                       <t>VERSION -                                       <t>VERSION -
# Line 2527  Schoenebeck'> Line 2529  Schoenebeck'>
2529                                          <list>                                          <list>
2530                                              <t>the file name of the loaded instrument, "NONE" if                                              <t>the file name of the loaded instrument, "NONE" if
2531                                              there's no instrument yet loaded for this sampler                                              there's no instrument yet loaded for this sampler
2532                                              channel</t>                                              channel (note: since LSCP 1.2 this path may contain
2533                                                <xref target="character_set">escape sequences</xref>)</t>
2534                                          </list>                                          </list>
2535                                      </t>                                      </t>
2536                                      <t>INSTRUMENT_NR -                                      <t>INSTRUMENT_NR -
# Line 2537  Schoenebeck'> Line 2540  Schoenebeck'>
2540                                      </t>                                      </t>
2541                                      <t>INSTRUMENT_NAME -                                      <t>INSTRUMENT_NAME -
2542                                          <list>                                          <list>
2543                                              <t>the instrument name of the loaded instrument</t>                                              <t>the instrument name of the loaded instrument
2544                                                (note: since LSCP 1.2 this character string may contain
2545                                                <xref target="character_set">escape sequences</xref>)</t>
2546                                          </list>                                          </list>
2547                                      </t>                                      </t>
2548                                      <t>INSTRUMENT_STATUS -                                      <t>INSTRUMENT_STATUS -
# Line 3447  Schoenebeck'> Line 3452  Schoenebeck'>
3452                                  <list>                                  <list>
3453                                      <t>NAME -                                      <t>NAME -
3454                                          <list>                                          <list>
3455                                              <t>name of the effect send entity</t>                                              <t>name of the effect send entity
3456                                                (note that this character string may contain
3457                                                 <xref target="character_set">escape sequences</xref>)</t>
3458                                          </list>                                          </list>
3459                                      </t>                                      </t>
3460                                      <t>MIDI_CONTROLLER -                                      <t>MIDI_CONTROLLER -
# Line 3917  Schoenebeck'> Line 3924  Schoenebeck'>
3924                      </t>                      </t>
3925                  </section>                  </section>
3926    
3927                    <section title="Current number of active disk streams" anchor="GET TOTAL_STREAM_COUNT">
3928                        <t>The front-end can ask for the current number of active disk streams on
3929                        the sampler by sending the following command:</t>
3930                        <t>
3931                            <list>
3932                                <t>GET TOTAL_STREAM_COUNT</t>
3933                            </list>
3934                        </t>
3935    
3936                        <t>Possible Answers:</t>
3937                        <t>
3938                            <list>
3939                                <t>LinuxSampler will answer by returning the number of all active
3940                                disk streams on the sampler.</t>
3941                            </list>
3942                        </t>
3943                    </section>
3944    
3945                  <section title="Reset sampler" anchor="RESET">                  <section title="Reset sampler" anchor="RESET">
3946                      <t>The front-end can reset the whole sampler by sending the following command:</t>                      <t>The front-end can reset the whole sampler by sending the following command:</t>
3947                      <t>                      <t>
# Line 4266  Schoenebeck'> Line 4291  Schoenebeck'>
4291                                      <t>NAME -                                      <t>NAME -
4292                                          <list>                                          <list>
4293                                              <t>custom name of the given map,                                              <t>custom name of the given map,
4294                                              which does not have to be unique</t>                                              which does not have to be unique
4295                                                (note that this character string may contain
4296                                                 <xref target="character_set">escape sequences</xref>)</t>
4297                                          </list>                                          </list>
4298                                      </t>                                      </t>
4299                                      <t>DEFAULT -                                      <t>DEFAULT -
# Line 4663  Schoenebeck'> Line 4690  Schoenebeck'>
4690                                      name for this mapped instrument. It can be set and                                      name for this mapped instrument. It can be set and
4691                                      changed with the                                      changed with the
4692                                      <xref target="MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"</xref>                                      <xref target="MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"</xref>
4693                                      command and does not have to be unique.</t>                                      command and does not have to be unique.
4694                                        (note that this character string may contain
4695                                        <xref target="character_set">escape sequences</xref>)</t>
4696                                  </list>                                  </list>
4697                              </t>                              </t>
4698                              <t>"ENGINE_NAME" -                              <t>"ENGINE_NAME" -
# Line 4674  Schoenebeck'> Line 4703  Schoenebeck'>
4703                              </t>                              </t>
4704                              <t>"INSTRUMENT_FILE" -                              <t>"INSTRUMENT_FILE" -
4705                                  <list>                                  <list>
4706                                      <t>File name of the instrument.</t>                                      <t>File name of the instrument
4707                                        (note that this path may contain
4708                                        <xref target="character_set">escape sequences</xref>).</t>
4709                                  </list>                                  </list>
4710                              </t>                              </t>
4711                              <t>"INSTRUMENT_NR" -                              <t>"INSTRUMENT_NR" -
# Line 4686  Schoenebeck'> Line 4717  Schoenebeck'>
4717                                  <list>                                  <list>
4718                                      <t>Name of the loaded instrument as reflected by its file.                                      <t>Name of the loaded instrument as reflected by its file.
4719                                      In contrast to the "NAME" field, the "INSTRUMENT_NAME" field                                      In contrast to the "NAME" field, the "INSTRUMENT_NAME" field
4720                                      cannot be changed.</t>                                      cannot be changed (note that this character string may contain
4721                                        <xref target="character_set">escape sequences</xref>).</t>
4722                                  </list>                                  </list>
4723                              </t>                              </t>
4724                              <t>"LOAD_MODE" -                              <t>"LOAD_MODE" -
# Line 5983  Schoenebeck'> Line 6015  Schoenebeck'>
6015                      editor application by sending the following command:</t>                      editor application by sending the following command:</t>
6016                      <t>                      <t>
6017                          <list>                          <list>
6018                              <t>EDIT INSTRUMENT &lt;sampler-channel&gt;</t>                              <t>EDIT CHANNEL INSTRUMENT &lt;sampler-channel&gt;</t>
6019                          </list>                          </list>
6020                      </t>                      </t>
6021                      <t>Where &lt;sampler-channel&gt; should be replaced by the                      <t>Where &lt;sampler-channel&gt; should be replaced by the
# Line 6035  Schoenebeck'> Line 6067  Schoenebeck'>
6067                      <t>Examples:</t>                      <t>Examples:</t>
6068                      <t>                      <t>
6069                          <list>                          <list>
6070                              <t>C: "EDIT INSTRUMENT 0"</t>                              <t>C: "EDIT CHANNEL INSTRUMENT 0"</t>
6071                              <t>S: "OK"</t>                              <t>S: "OK"</t>
6072                          </list>                          </list>
6073                      </t>                      </t>
# Line 6528  Schoenebeck'> Line 6560  Schoenebeck'>
6560  </t>  </t>
6561  <t>edit_instruction =  <t>edit_instruction =
6562          <list>          <list>
6563                  <t>INSTRUMENT SP sampler_channel                  <t>CHANNEL SP INSTRUMENT SP sampler_channel
6564                  </t>                  </t>
6565          </list>          </list>
6566  </t>  </t>
# Line 6824  Schoenebeck'> Line 6856  Schoenebeck'>
6856                  in the old versions a single backslash was sufficient.</t>                  in the old versions a single backslash was sufficient.</t>
6857    
6858                  <t>The following LSCP commands support escape sequences as part                  <t>The following LSCP commands support escape sequences as part
6859                  of their filename / path based arguments:                  of their filename / path based arguments and / or may contain
6860                    a filename / path with escape sequences in their response:
6861                  <list>                  <list>
6862                      <t><xref target="LOAD INSTRUMENT">"LOAD INSTRUMENT"</xref></t>                      <t><xref target="LOAD INSTRUMENT">"LOAD INSTRUMENT"</xref></t>
6863                        <t><xref target="GET CHANNEL INFO">"GET CHANNEL INFO"</xref></t>
6864                      <t><xref target="MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"</xref></t>                      <t><xref target="MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"</xref></t>
6865                        <t><xref target="GET MIDI_INSTRUMENT INFO">"GET MIDI_INSTRUMENT INFO"</xref></t>
6866                      <t><xref target="ADD DB_INSTRUMENT_DIRECTORY">"ADD DB_INSTRUMENT_DIRECTORY"</xref></t>                      <t><xref target="ADD DB_INSTRUMENT_DIRECTORY">"ADD DB_INSTRUMENT_DIRECTORY"</xref></t>
6867                      <t><xref target="ADD DB_INSTRUMENTS">"ADD DB_INSTRUMENTS"</xref></t>                      <t><xref target="ADD DB_INSTRUMENTS">"ADD DB_INSTRUMENTS"</xref></t>
6868                      <t><xref target="REMOVE DB_INSTRUMENT_DIRECTORY">"REMOVE DB_INSTRUMENT_DIRECTORY"</xref></t>                      <t><xref target="REMOVE DB_INSTRUMENT_DIRECTORY">"REMOVE DB_INSTRUMENT_DIRECTORY"</xref></t>
# Line 6860  Schoenebeck'> Line 6895  Schoenebeck'>
6895                  <t>                  <t>
6896                  The following LSCP commands even support escape sequences as                  The following LSCP commands even support escape sequences as
6897                  part of at least one of their text-based arguments (i.e. entity name,                  part of at least one of their text-based arguments (i.e. entity name,
6898                  description):                  description) and / or may contain escape sequences in at least one of
6899                    their text-based fields in their response:
6900                  <list>                  <list>
6901                        <t><xref target="GET SERVER INFO">"GET SERVER INFO"</xref></t>
6902                        <t><xref target="GET ENGINE INFO">"GET ENGINE INFO"</xref></t>
6903                        <t><xref target="GET CHANNEL INFO">"GET CHANNEL INFO"</xref></t>
6904                      <t><xref target="CREATE FX_SEND">"CREATE FX_SEND"</xref></t>                      <t><xref target="CREATE FX_SEND">"CREATE FX_SEND"</xref></t>
6905                        <t><xref target="GET FX_SEND INFO">"GET FX_SEND INFO"</xref></t>
6906                      <t><xref target="SET FX_SEND NAME">"SET FX_SEND NAME"</xref></t>                      <t><xref target="SET FX_SEND NAME">"SET FX_SEND NAME"</xref></t>
6907                        <t><xref target="GET MIDI_INSTRUMENT INFO">"GET MIDI_INSTRUMENT INFO"</xref></t>
6908                        <t><xref target="GET MIDI_INSTRUMENT_MAP INFO">"GET MIDI_INSTRUMENT_MAP INFO"</xref></t>
6909                      <t><xref target="ADD MIDI_INSTRUMENT_MAP">"ADD MIDI_INSTRUMENT_MAP"</xref></t>                      <t><xref target="ADD MIDI_INSTRUMENT_MAP">"ADD MIDI_INSTRUMENT_MAP"</xref></t>
6910                      <t><xref target="MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"</xref></t>                      <t><xref target="MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"</xref></t>
6911                      <t><xref target="SET MIDI_INSTRUMENT_MAP NAME">"SET MIDI_INSTRUMENT_MAP NAME"</xref></t>                      <t><xref target="SET MIDI_INSTRUMENT_MAP NAME">"SET MIDI_INSTRUMENT_MAP NAME"</xref></t>
6912                        <t><xref target="GET DB_INSTRUMENT_DIRECTORY INFO">"GET DB_INSTRUMENT_DIRECTORY INFO"</xref></t>
6913                      <t><xref target="SET DB_INSTRUMENT_DIRECTORY NAME">"SET DB_INSTRUMENT_DIRECTORY NAME"</xref></t>                      <t><xref target="SET DB_INSTRUMENT_DIRECTORY NAME">"SET DB_INSTRUMENT_DIRECTORY NAME"</xref></t>
6914                      <t><xref target="SET DB_INSTRUMENT_DIRECTORY DESCRIPTION">"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"</xref></t>                      <t><xref target="SET DB_INSTRUMENT_DIRECTORY DESCRIPTION">"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"</xref></t>
6915                      <t><xref target="FIND DB_INSTRUMENT_DIRECTORIES">"FIND DB_INSTRUMENT_DIRECTORIES"</xref></t>                      <t><xref target="FIND DB_INSTRUMENT_DIRECTORIES">"FIND DB_INSTRUMENT_DIRECTORIES"</xref></t>
6916                        <t><xref target="GET DB_INSTRUMENT INFO">"GET DB_INSTRUMENT INFO"</xref></t>
6917                      <t><xref target="SET DB_INSTRUMENT NAME">"SET DB_INSTRUMENT NAME"</xref></t>                      <t><xref target="SET DB_INSTRUMENT NAME">"SET DB_INSTRUMENT NAME"</xref></t>
6918                      <t><xref target="SET DB_INSTRUMENT DESCRIPTION">"SET DB_INSTRUMENT DESCRIPTION"</xref></t>                      <t><xref target="SET DB_INSTRUMENT DESCRIPTION">"SET DB_INSTRUMENT DESCRIPTION"</xref></t>
6919                      <t><xref target="FIND DB_INSTRUMENTS">"FIND DB_INSTRUMENTS"</xref></t>                      <t><xref target="FIND DB_INSTRUMENTS">"FIND DB_INSTRUMENTS"</xref></t>
# Line 7119  Schoenebeck'> Line 7163  Schoenebeck'>
7163                  all currently active voices.</t>                  all currently active voices.</t>
7164              </section>              </section>
7165    
7166                <section title="Total number of active disk streams changed" anchor="SUBSCRIBE TOTAL_STREAM_COUNT">
7167                    <t>Client may want to be notified when the total number of disk streams on the
7168                    back-end changes by issuing the following command:</t>
7169                    <t>
7170                        <list>
7171                            <t>SUBSCRIBE TOTAL_STREAM_COUNT</t>
7172                        </list>
7173                    </t>
7174                    <t>Server will start sending the following notification messages:</t>
7175                    <t>
7176                        <list>
7177                            <t>"NOTIFY:TOTAL_STREAM_COUNT:&lt;streams&gt;"</t>
7178                        </list>
7179                    </t>
7180                    <t>where &lt;streams&gt; will be replaced by the new number of
7181                    all currently active disk streams.</t>
7182                </section>
7183    
7184              <section title="Number of MIDI instrument maps changed" anchor="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">              <section title="Number of MIDI instrument maps changed" anchor="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">
7185                  <t>Client may want to be notified when the number of MIDI instrument maps on the                  <t>Client may want to be notified when the number of MIDI instrument maps on the
7186                  back-end changes by issuing the following command:</t>                  back-end changes by issuing the following command:</t>
Legend:
Removed from v.1391  
changed lines
  Added in v.1541
  ViewVC Help
Powered by ViewVC