34 |
<email>schoenebeck at software minus engineering dot org</email> |
<email>schoenebeck at software minus engineering dot org</email> |
35 |
</address> |
</address> |
36 |
</author> |
</author> |
37 |
<date month="February" year="2008"/> |
<date month="April" year="2008"/> |
38 |
<workgroup>LinuxSampler Developers</workgroup> |
<workgroup>LinuxSampler Developers</workgroup> |
39 |
<keyword>LSCP</keyword> |
<keyword>LSCP</keyword> |
40 |
<abstract> |
<abstract> |
6003 |
</t> |
</t> |
6004 |
</section> |
</section> |
6005 |
|
|
6006 |
|
<section title="Checking for lost instrument files" anchor="FIND LOST DB_INSTRUMENT_FILES"> |
6007 |
|
<t>The front-end can retrieve the list of all instrument files in the instruments database |
6008 |
|
that don't exist in the filesystem by sending the following command:</t> |
6009 |
|
<t> |
6010 |
|
<list> |
6011 |
|
<t>FIND LOST DB_INSTRUMENT_FILES</t> |
6012 |
|
</list> |
6013 |
|
</t> |
6014 |
|
|
6015 |
|
<t>Possible Answers:</t> |
6016 |
|
<t> |
6017 |
|
<list> |
6018 |
|
<t>A comma separated list with the absolute path names |
6019 |
|
(encapsulated into apostrophes) of all lost instrument files.</t> |
6020 |
|
<t>"ERR:<error-code>:<error-message>" - |
6021 |
|
<list> |
6022 |
|
<t>in case it failed, providing an appropriate error code and error message.</t> |
6023 |
|
</list> |
6024 |
|
</t> |
6025 |
|
</list> |
6026 |
|
</t> |
6027 |
|
<t>Example:</t> |
6028 |
|
<t> |
6029 |
|
<list> |
6030 |
|
<t>C: "FIND LOST DB_INSTRUMENT_FILES"</t> |
6031 |
|
<t>S: "'/gigs/Bosendorfer 290.gig','/gigs/Steinway D.gig','/gigs/Free Piano.gig'"</t> |
6032 |
|
</list> |
6033 |
|
</t> |
6034 |
|
</section> |
6035 |
|
|
6036 |
|
<section title="Replacing an instrument file" anchor="SET DB_INSTRUMENT FILE_PATH"> |
6037 |
|
<t>The front-end can substitute all occurrences of an instrument file |
6038 |
|
in the instruments database with a new one by sending the following command:</t> |
6039 |
|
<t> |
6040 |
|
<list> |
6041 |
|
<t>SET DB_INSTRUMENT FILE_PATH <old_path> <new_path></t> |
6042 |
|
</list> |
6043 |
|
</t> |
6044 |
|
<t>Where <old_path> is the absolute path name of the instrument file |
6045 |
|
to substitute with <new_path>.</t> |
6046 |
|
|
6047 |
|
<t>Possible Answers:</t> |
6048 |
|
<t> |
6049 |
|
<list> |
6050 |
|
<t>"OK" - |
6051 |
|
<list> |
6052 |
|
<t>on success</t> |
6053 |
|
</list> |
6054 |
|
</t> |
6055 |
|
<t>"ERR:<error-code>:<error-message>" - |
6056 |
|
<list> |
6057 |
|
<t>in case it failed, providing an appropriate error code and error message.</t> |
6058 |
|
</list> |
6059 |
|
</t> |
6060 |
|
</list> |
6061 |
|
</t> |
6062 |
|
|
6063 |
|
<t>Example:</t> |
6064 |
|
<t> |
6065 |
|
<list> |
6066 |
|
<t>C: "SET DB_INSTRUMENT FILE_PATH '/gigs/Bosendorfer 290.gig' '/gigs/pianos/Bosendorfer 290.gig'"</t> |
6067 |
|
<t>S: "OK"</t> |
6068 |
|
</list> |
6069 |
|
</t> |
6070 |
|
</section> |
6071 |
|
|
6072 |
</section> |
</section> |
6073 |
|
|
6074 |
|
|
6715 |
</t> |
</t> |
6716 |
<t>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped |
<t>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped |
6717 |
</t> |
</t> |
6718 |
|
<t>/ DB_INSTRUMENT SP FILE_PATH SP filename SP filename |
6719 |
|
</t> |
6720 |
<t>/ ECHO SP boolean |
<t>/ ECHO SP boolean |
6721 |
</t> |
</t> |
6722 |
<t>/ VOLUME SP volume_value |
<t>/ VOLUME SP volume_value |
6763 |
</t> |
</t> |
6764 |
<t>/ DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list |
<t>/ DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list |
6765 |
</t> |
</t> |
6766 |
|
<t>/ LOST SP DB_INSTRUMENT_FILES |
6767 |
|
</t> |
6768 |
</list> |
</list> |
6769 |
</t> |
</t> |
6770 |
<t>move_instruction = |
<t>move_instruction = |
7160 |
<t><xref target="MOVE DB_INSTRUMENT_DIRECTORY">"MOVE DB_INSTRUMENT_DIRECTORY"</xref></t> |
<t><xref target="MOVE DB_INSTRUMENT_DIRECTORY">"MOVE DB_INSTRUMENT_DIRECTORY"</xref></t> |
7161 |
<t><xref target="COPY DB_INSTRUMENT">"COPY DB_INSTRUMENT"</xref></t> |
<t><xref target="COPY DB_INSTRUMENT">"COPY DB_INSTRUMENT"</xref></t> |
7162 |
<t><xref target="COPY DB_INSTRUMENT_DIRECTORY">"COPY DB_INSTRUMENT_DIRECTORY"</xref></t> |
<t><xref target="COPY DB_INSTRUMENT_DIRECTORY">"COPY DB_INSTRUMENT_DIRECTORY"</xref></t> |
7163 |
|
<t><xref target="FIND LOST DB_INSTRUMENT_FILES">"FIND LOST DB_INSTRUMENT_FILES"</xref></t> |
7164 |
|
<t><xref target="SET DB_INSTRUMENT FILE_PATH">"SET DB_INSTRUMENT FILE_PATH"</xref></t> |
7165 |
<t><xref target="GET FILE INSTRUMENTS">"GET FILE INSTRUMENTS"</xref></t> |
<t><xref target="GET FILE INSTRUMENTS">"GET FILE INSTRUMENTS"</xref></t> |
7166 |
<t><xref target="LIST FILE INSTRUMENTS">"LIST FILE INSTRUMENTS"</xref></t> |
<t><xref target="LIST FILE INSTRUMENTS">"LIST FILE INSTRUMENTS"</xref></t> |
7167 |
<t><xref target="GET FILE INSTRUMENT INFO">"GET FILE INSTRUMENT INFO"</xref></t> |
<t><xref target="GET FILE INSTRUMENT INFO">"GET FILE INSTRUMENT INFO"</xref></t> |
7353 |
<t>Server will start sending one of the the following notification messages:</t> |
<t>Server will start sending one of the the following notification messages:</t> |
7354 |
<t> |
<t> |
7355 |
<list> |
<list> |
7356 |
<t>"NOTIFY:CHANNEL_MIDI:<device-id> <port-id> NOTE_ON <note> <velocity>"</t> |
<t>"NOTIFY:DEVICE_MIDI:<device-id> <port-id> NOTE_ON <note> <velocity>"</t> |
7357 |
<t>"NOTIFY:CHANNEL_MIDI:<device-id> <port-id> NOTE_OFF <note> <velocity>"</t> |
<t>"NOTIFY:DEVICE_MIDI:<device-id> <port-id> NOTE_OFF <note> <velocity>"</t> |
7358 |
</list> |
</list> |
7359 |
</t> |
</t> |
7360 |
<t>where <device-id> <port-id> will be replaced |
<t>where <device-id> <port-id> will be replaced |