--- web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.txt 2005/05/21 11:47:55 560 +++ web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.txt 2005/05/21 20:01:32 561 @@ -813,7 +813,7 @@ false only a single value allowed (always returned, no matter which driver parameter) DEPENDS - - comma separated list of paramters this parameter depends on, + comma separated list of parameters this parameter depends on, means the values for fields 'DEFAULT', 'RANGE_MIN', 'RANGE_MAX' and 'POSSIBILITIES' might depend on these listed parameters, for example assuming that an audio driver (like the ALSA @@ -1420,17 +1420,17 @@ GET MIDI_INPUT_DRIVER_PARAMETER INFO [] - Where is the name of the MIDI input driver as returned by - the "LIST AVAILABLE_MIDI_INPUT_DRIVERS" (Section 5.3.2) command, - a specific parameter name for which information should be - obtained (as returned by the "GET MIDI_INPUT_DRIVER INFO" (Section - 5.3.3) command) and is an optional list of parameters on - which the sought parameter depends on, is a - key-value pair list in form of "key1=val1 key2=val2 ...", where - character string values are encapsulated into apostrophes ('). - Arguments given with which are not dependency parameters of - will be ignored, means the front-end application can simply - put all parameters in with the values selected by the user. + Where is the name of the MIDI input driver as returned by the + "LIST AVAILABLE_MIDI_INPUT_DRIVERS" (Section 5.3.2) command, + a specific parameter name for which information should be obtained + (as returned by the "GET MIDI_INPUT_DRIVER INFO" (Section 5.3.3) + command) and is an optional list of parameters on which the + sought parameter depends on, is a key-value pair + list in form of "key1=val1 key2=val2 ...", where character string + values are encapsulated into apostrophes ('). Arguments given with + which are not dependency parameters of will be + ignored, means the front-end application can simply put all + parameters in with the values selected by the user. Possible Answers: @@ -1476,7 +1476,7 @@ false only a single value allowed (always returned, no matter which driver parameter) DEPENDS - - comma separated list of paramters this parameter depends on, + comma separated list of parameters this parameter depends on, means the values for fields 'DEFAULT', 'RANGE_MIN', 'RANGE_MAX' and 'POSSIBILITIES' might depend on these listed parameters, for example assuming that an audio driver (like the ALSA @@ -2027,8 +2027,8 @@ "OK[]" - in case a new sampler channel could be added, where reflects the channel number of the new - created sampler channel which should the be used to set up the - sampler channel by sending subsequent intialization commands + created sampler channel which should be used to set up the + sampler channel by sending subsequent initialization commands "WRN::" - in case a new channel was added successfully, but there are noteworthy issue(s) related, providing an appropriate warning @@ -2047,9 +2047,10 @@ REMOVE CHANNEL - This will decrement the sampler channel count by one and also - decrement the channel numbers of all subsequent sampler channels by - one. + Where should be replaced by the number of the + sampler channel as given by the "ADD CHANNEL" (Section 5.4.5) or + "LIST CHANNELS" (Section 5.4.4) command. The channel numbers of all + subsequent sampler channels remain the same. Possible Answers: @@ -2067,7 +2068,6 @@ - Schoenebeck Expires November 19, 2005 [Page 37] Internet-Draft LinuxSampler Control Protocol May 2005 @@ -2101,14 +2101,15 @@ Possible Answers: - LinuxSampler will answer by sending a comma separated character - string of the engines' names. Engine names can consist of lower - and upper cases, digits and underlines ("_" character). + LinuxSampler will answer by sending a comma separated list of the + engines' names encapsulated into apostrophes ('). Engine names + can consist of lower and upper cases, digits and underlines ("_" + character). Example: C: "LIST AVAILABLE_ENGINES" - S: "GigEngine,AkaiEngine,DLSEngine,JoesCustomEngine" + S: "'GigEngine','AkaiEngine','DLSEngine','JoesCustomEngine'" 5.4.9 Getting information about an engine @@ -2120,7 +2121,6 @@ Where is an engine name as obtained by the "LIST AVAILABLE_ENGINES" (Section 5.4.8) command. - Possible Answers: @@ -2129,6 +2129,8 @@ Internet-Draft LinuxSampler Control Protocol May 2005 + Possible Answers: + LinuxSampler will answer by sending a separated list. Each answer line begins with the information category name followed by a colon and then a space character and finally the info @@ -2175,8 +2177,6 @@ numerical ID of the audio output device which is currently connected to this sampler channel to output the audio signal, "NONE" if there's no device connected to this - sampler channel - @@ -2185,6 +2185,7 @@ Internet-Draft LinuxSampler Control Protocol May 2005 + sampler channel AUDIO_OUTPUT_CHANNELS - number of output channels the sampler channel offers (dependent to used sampler engine and loaded instrument) @@ -2231,7 +2232,6 @@ "VOLUME: 1.0" "AUDIO_OUTPUT_DEVICE: 0" "AUDIO_OUTPUT_CHANNELS: 2" - "AUDIO_OUTPUT_ROUTING: 0,1" @@ -2241,6 +2241,7 @@ Internet-Draft LinuxSampler Control Protocol May 2005 + "AUDIO_OUTPUT_ROUTING: 0,1" "INSTRUMENT_FILE: /home/joe/FazioliPiano.gig" "INSTRUMENT_NR: 0" "INSTRUMENT_NAME: Fazioli Piano" @@ -2291,7 +2292,6 @@ - Schoenebeck Expires November 19, 2005 [Page 41] Internet-Draft LinuxSampler Control Protocol May 2005 @@ -2529,7 +2529,7 @@ message "ERR::" - in case it failed, providing an appropriate error code and - error messag + error message Examples: @@ -2935,7 +2935,7 @@ 7.5 Channel information changed Client may want to be notified when changes were made to sampler - channels on the back-end changes by issuing the following command: + channels on the back-end by issuing the following command: SUBSCRIBE CHANNEL_INFO @@ -3090,6 +3090,7 @@ Rui Nuno Capela Vladimir Senkov Mark Knecht + Grigor Iliev 10 References @@ -3109,7 +3110,6 @@ -