--- linuxsampler/trunk/Documentation/lscp.xml 2007/10/07 11:10:02 1388
+++ linuxsampler/trunk/Documentation/lscp.xml 2007/10/07 14:05:04 1389
@@ -34,7 +34,7 @@
schoenebeck at software minus engineering dot org
-
+
LinuxSampler Developers
LSCP
@@ -3255,7 +3255,9 @@
sampler channel on which the effect send should be created on, <midi-ctrl>
is a number between 0..127 defining the MIDI controller which can alter the
effect send level and <name> is an optional argument defining a name
- for the effect send entity. The name does not have to be unique.
+ for the effect send entity. The name does not have to be unique, but MUST be
+ encapsulated into apostrophes and supports escape sequences as described in chapter
+ "Character Set and Escape Sequences".
By default, that is as initial routing, the effect send's audio channels
are automatically routed to the last audio channels of the sampler channel's
@@ -3508,7 +3510,10 @@
as returned by the "CREATE FX_SEND"
or "LIST FX_SENDS" command and
<name> is the new name of the effect send entity, which
- does not have to be unique.
+ does not have to be unique (name MUST be encapsulated into apostrophes
+ and supports escape sequences as described in chapter
+ "Character Set and Escape Sequences").
+
Possible Answers:
@@ -3959,8 +3964,8 @@
DESCRIPTION -
- arbitrary textual description about the sampler
- (note that the character string may contain
+ arbitrary textual description about the sampler
+ (note that the character string may contain
escape sequences)
@@ -4077,7 +4082,7 @@
cause the sampler to switch to the respective instrument as
reflected by the current MIDI instrument map.
-
+
The front-end can add a new MIDI instrument map by sending
the following command:
@@ -4087,7 +4092,10 @@
Where <name> is an optional argument allowing to
assign a custom name to the new map. MIDI instrument Map
- names do not have to be unique.
+ names do not have to be unique, but MUST be encapsulated
+ into apostrophes and support escape sequences as described
+ in chapter "Character Set and Escape Sequences".
+
Possible Answers:
@@ -4294,7 +4302,10 @@
Where <map> is the numerical ID of the map and
<name> the new custom name of the map, which does not
- have to be unique.
+ have to be unique (name MUST be encapsulated into apostrophes
+ and supports escape sequences as described in chapter
+ "Character Set and Escape Sequences").
+
Possible Answers:
@@ -6393,13 +6404,13 @@
/ FX_SEND SP LEVEL SP sampler_channel SP fx_send_id SP volume_value
- / DB_INSTRUMENT_DIRECTORY SP NAME SP db_path SP raw_path
+ / DB_INSTRUMENT_DIRECTORY SP NAME SP db_path SP stringval_escaped
- / DB_INSTRUMENT_DIRECTORY SP DESCRIPTION SP db_path SP raw_path
+ / DB_INSTRUMENT_DIRECTORY SP DESCRIPTION SP db_path SP stringval_escaped
- / DB_INSTRUMENT SP NAME SP db_path SP raw_path
+ / DB_INSTRUMENT SP NAME SP db_path SP stringval_escaped
- / DB_INSTRUMENT SP DESCRIPTION SP db_path SP raw_path
+ / DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped
/ ECHO SP boolean
@@ -6715,19 +6726,19 @@
map_name =
- stringval
+ stringval_escaped
entry_name =
- stringval
+ stringval_escaped
fx_send_name =
- stringval
+ stringval_escaped
@@ -6762,9 +6773,9 @@
query_val =
- raw_path_base
+ text_escaped
- / raw_path
+ / stringval_escaped
@@ -6811,6 +6822,59 @@
where escape characters are now supported, a backslash characters
MUST be escaped as well (that is as double backslash), whereas
in the old versions a single backslash was sufficient.
+
+ The following LSCP commands support escape sequences as part
+ of their filename / path based arguments:
+
+ "LOAD INSTRUMENT"
+ "MAP MIDI_INSTRUMENT"
+ "ADD DB_INSTRUMENT_DIRECTORY"
+ "ADD DB_INSTRUMENTS"
+ "REMOVE DB_INSTRUMENT_DIRECTORY"
+ "REMOVE DB_INSTRUMENT"
+ "GET DB_INSTRUMENT_DIRECTORIES"
+ "LIST DB_INSTRUMENT_DIRECTORIES"
+ "GET DB_INSTRUMENT_DIRECTORY INFO"
+ "GET DB_INSTRUMENTS"
+ "LIST DB_INSTRUMENTS"
+ "GET DB_INSTRUMENT INFO"
+ "SET DB_INSTRUMENT_DIRECTORY NAME"
+ "SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"
+ "SET DB_INSTRUMENT NAME"
+ "SET DB_INSTRUMENT DESCRIPTION"
+ "FIND DB_INSTRUMENTS"
+ "FIND DB_INSTRUMENT_DIRECTORIES"
+ "MOVE DB_INSTRUMENT"
+ "MOVE DB_INSTRUMENT_DIRECTORY"
+ "COPY DB_INSTRUMENT"
+ "COPY DB_INSTRUMENT_DIRECTORY"
+
+ Note that the forward slash character ('/') has a special meaning in
+ filename / path based arguments: it acts as separator of the nodes in
+ the path, thus if a directory- or filename includes a forward slash
+ (not intended as path node separator), you MUST escape that slash
+ either with the respective hex escape sequence ("\x2f") or with the
+ respective octal escape sequence ("\057").
+
+
+
+ The following LSCP commands even support escape sequences as
+ part of at least one of their text-based arguments (i.e. entity name,
+ description):
+
+ "ADD MIDI_INSTRUMENT_MAP"
+ "MAP MIDI_INSTRUMENT"
+ "SET MIDI_INSTRUMENT_MAP NAME"
+ "SET DB_INSTRUMENT_DIRECTORY NAME"
+ "SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"
+ "SET DB_INSTRUMENT NAME"
+ "SET DB_INSTRUMENT DESCRIPTION"
+ "FIND DB_INSTRUMENT_DIRECTORIES"
+
+ Please note that these lists are manually maintained. If you
+ find a command that also supports escape sequences we forgot to
+ mention here, please report it!
+