[Linuxsampler-devel] LSCP (7th draft)

[Christian S. <chr...@ep...>]

Hi!

I updated the protocol document (maybe the last time until the first release 
of LS):

	http://www.linuxsampler.org/api/draft-linuxsampler-protocol-06.pdf
	http://www.linuxsampler.org/api/draft-linuxsampler-protocol-06.sxw

Changes to already implemented commands (IMPORTANT):

	* command "GET CHANNELS" (4.4.3) will soon return a comma separated list of
	  all created sampler channels instead of a channel count, this allows 
	  discontinuous channel numbers and brings atomicity e.g. when removing a
	  sampler channel

	* command "SET CHANNEL AUDIO_OUTPUT_TYPE" is now deprecated and will probably
	  disappear after the new command "SET CHANNEL AUDIO_OUTPUT_DEVICE" (4.4.12)
	  is implemented

	* command "SET CHANNEL_MIDI_INPUT_TYPE" is now deprecated and will probably
	  disappear after the new command "SET CHANNEL MIDI_INPUT_DEVICE" (4.4.16)
	  is implemented

Changes to recent, not yet implemented commands:

	* applied Vladimir's proposal to allow multiple instances of audio drivers
	  (4.2.4, 4.2.5, 4.2.6, 4.2.7, 4.2.8, 4.2.9, 4.2.10, 4.2.11, 4.3.4, 4.3.5,
	  4.3.6, 4.3.7, 4.3.8, 4.3.9, 4.3.10, 4.3.11)

	* replaced occurences of "TYPE" which actually means driver by "DRIVER" (e.g.
	  "GET AVAILABLE_AUDIO_OUTPUT_TYPES" is now "GET
	  AVAILABLE_AUDIO_OUTPUT_DRIVERS" - 4.2.1, 4.2.2, 4.2.3, 4.2.7, 4.3.1, 4.3.2,
	  4.3.3, 4.4.8)

	* fields RANGE_MIN may also appear without RANGE_MAX and RANGE_MAX may also
	  appear without RANGE_MIN respectively (4.2.3, 4.3.3)

	* fixed some examples in chapter 4.2 et seqq.

Additions:

	* white lines and lines starting with a '#' character will be ignored, thus
	  allows to group commands and to place comments

	* added field "TYPE" to parameter info commands to reflect the value type of 
	  the parameter which either is "BOOL", "INT", "FLOAT" or "STRING" (4.2.3,
	  4.2.10, 4.3.3, 4.3.10)

I know that's really a bunch, but no fear; that's it. At least from my side I 
won't change anything now in the protocol definition before the first release 
of LS.

If you dislike something in the protocol or if there's something unclear, let 
me know! Otherwise we will soon start to implement all commands as described 
in this 7th draft.

CU
Christian

P.S. If anybody has a good idea how to convert the document to plain text 
format while keeping headers and footers (title, page count, date), etc. let 
me know!