Annotation of /liblscp/trunk/ChangeLog

liblscp - LinuxSampler Control Protocol API
-------------------------------------------

ChangeLog

0.9.0  2020-12-17  A Winter'20 release.

0.6.2  2019-03-24  A Spring'20 release.

                   Fixed compile errors on macOS.

                   Expose actual system error codes via client interface
                   instead of just -1 whenever a syscall failed.

                   Added new client interface function:
                     lscp_client_connection_lost();
                   for checking whether client lost connection to server.

                   Fixed potential missing NULL termination of locale strings.

0.6.1  2019-12-22  The Winter'19 Release.

0.6.0  2017-12-12  An Autumn'17 release.

0.5.8  2016-11-14  A Fall'16 release.

0.5.7  2013-12-31  Use getaddrinfo() instead of deprecated gethostbyname().

                   Update on newer autoconf macros (m4).

                   Fixes for building for Windows with configure and make.

                   Makefile fixes for building in separate directory.

                   Autoconf fix: AC_CONFIG_HEADER obsolete error (fixes #194).

0.5.6  2009-08-01  Fixed locale related parser bug (fixes #59).

                   Added new client interface functions, for managing
                   the global limit of maximum voices and disk streams:
                   lscp_get_voices(), lscp_set_voices(), lscp_get_streams(),
                   lscp_set_streams().

                   _lscp_device_port_info_query(): take port parameter
                   "NAME" into the result list.

                   Bugfix: _lscp_client_evt_proc() dropped LSCP events.

                   Bugfix in lscp_client_subscribe(): only the first
                   lscp_client_subscribe() call succeeded (per client),
                   all subsequent ones failed.

                   Added support for new (un)subscribable events:
                     LSCP_EVENT_CHANNEL_MIDI
                     LSCP_EVENT_DEVICE_MIDI
                   Caution: the bitflag approach for the event variable
                   is now abondoned, since otherwise we would soon hit the
                   limit of the bit range. The bitflag approach will
                   remain for events older at this point (that is all
                   events which occupy the lower 16 bits), but this new
                   and all following events will simply be enumared along
                   the upper 16 bits.

                   Added new client interface function, for renaming
                   effect send entities:
                     lscp_set_fxsend_name();

                   Added new client interface functions, for managing the
                   global limit of maximum voices and disk streams:
                     lscp_get_voices();
                     lscp_set_voices();
                     lscp_get_streams();
                     lscp_set_streams();

                   Bugfix: fixed buggy behavior on different locale
                   settings (e.g. when parsing floating point numbers).

0.5.5  2007-10-12  Changed client interface function, for editing
                   instrument, from:
                     lscp_edit_instrument();
                   to:
                     lscp_edit_channel_instrument();

0.5.4  2007-10-02  Added new client interface function, for editing
                   instrument:
                     lscp_edit_instrument();

                   Fixed some minor bugs in:
                     lscp_set_fxsend_midi_controller();
                     lscp_set_fxsend_level();

0.5.3  2007-01-15  Added new client interface functions, for sampler
                   channel effect sends control:
                     lscp_set_fxsend_midi_controller();
                     lscp_set_fxsend_level();

                   Added new field member to lscp_fxsend_info_t (level).

0.5.2  2007-01-11  Added new client interface functions, for sampler
                   channel effect sends control:
                     lscp_create_fxsend();
                     lscp_destroy_fxsend();
                     lscp_get_fxsends();
                     lscp_list_fxsends();
                     lscp_get_fxsend_info();
                     lscp_set_fxsend_audio_channel();
                   and for global volume:
                     lscp_get_volume();
                     lscp_set_volume();

                   Audio routing representation changed to integer array.

0.5.1  2006-12-22  Added support for new (un)subscribable events:
                     LSCP_EVENT_AUDIO_OUTPUT_DEVICE_COUNT,
                     LSCP_EVENT_AUDIO_OUTPUT_DEVICE_INFO,
                     LSCP_EVENT_MIDI_INPUT_DEVICE_COUNT,
                     LSCP_EVENT_MIDI_INPUT_DEVICE_INFO,
                     LSCP_EVENT_MIDI_INSTRUMENT_MAP_COUNT,
                     LSCP_EVENT_MIDI_INSTRUMENT_MAP_INFO,
                     LSCP_EVENT_MIDI_INSTRUMENT_COUNT,
                     LSCP_EVENT_MIDI_INSTRUMENT_INFO.

                   Updated examples.

0.5.0  2006-12-17  MIDI instrument mapping, second round, according to
                   LSCP 1.2 draft document as of December 15, 2006.

                   New client interface functions:
                     lscp_set_channel_midi_map();
                     lscp_add_midi_instrument_map();
                     lscp_remove_midi_instrument_map();
                     lscp_get_midi_instrument_maps();
                     lscp_list_midi_instrument_maps();
                     lscp_get_midi_instrument_map_name();
                     lscp_set_midi_instrument_map_name();


0.4.2  2006-12-04  MIDI instrument mapping fixed, previously missing
                   the regular ON_DEMAND load mode.

                   Server error reporting is now effective; all server
                   numerical error and warning codes are added to 100,
                   thus giving a proper non-zero lscp_client_get_errno()
                   return value.

0.4.1  2006-11-28  Fixed the flush timeout operation to be issued only
                   once, avoiding recurrent client failure after receive
                   timeout.

                   Support for very long command result sets have been
                   introduced, with the downside of strictly obeying
                   the LSCP draft.

                   list_midi_instruments() is now being implemented.

                   LGPL text is now back in COPYING.

0.4.0  2006-11-27  As of the LSCP 1.2 working draft document, added
                   some missing client interface functions:
                     lscp_get_total_voice_count();
                     lscp_get_total_voice_count_max();
                   and for the new MIDI instrumenbt mapping features:
                     lscp_map_midi_instrument();
                     lscp_unmap_midi_instrument();
                     lscp_get_midi_instruments();
                     lscp_get_midi_instrument_info();
                     lscp_clear_midi_instruments();


0.3.4  2006-09-24  GPL address update.

0.3.3  2006-06-01  Fixed some compilation warnings due to suspicious type
                   casting and unsused header macros.

                   Changed deprecated copyright attribute to license
                   and added ldconfig to post-(un)install steps
                   to liblscp.spec (RPM).

0.3.2  2005-08-29  Fixed missing initialization bug on lscp_channel_info_t
                   new struct fields (mute/solo).

                   Include debian files into distribution.

                   Renamed configure.in to newer configure.ac.

0.3.1  2005-08-16  [bug #21] Fixed automake support for separate build
                   directory.

                   Added support to sampler channel MUTE/SOLO states:
                     lscp_set_channel_mute();
                     lscp_set_channel_solo();
                   with corresponding new lscp_channel_info_t fields.

0.3.0  2005-06-10  [bug #11] Timeout flush idiosyncrasy is now a feature;
                   this just tries to flush the receive buffer whenever
                   any previous transaction has failed due to a timeout.

                   Fixed an off-by-one timeout quirk, that has been a real
                   showstopper on Mac OS X at least, which is incidental
                   to qsampler's default timeout setting of 1000 msecs,
                   giving up systematically on select() due to "Invalid
                   argument" (EINVAL).


0.2.8  2005-05-22  More LSCP command syntax changes, particularly on the
                   event subscription ones: the LSCP_EVENT_CHANNELS event
                   definition were renamed to LSCP_EVENT_CHANNEL_COUNT,
                   as to be more meaningful. Added support for the newest
                   LSCP command: GET SERVER INFO; lscp_get_server_info().

0.2.8  2005-05-08  [bug #9] Fixed for a LSCP command syntax convention
                   consistency, regarding the enumeration of available
                   sampler engines, Audio and MIDI drivers; this has
                   affected the signature of the following functions:
                     lscp_get_available_engines();
                     lscp_get_available_audio_drivers();
                     lscp_get_available_midi_drivers();
                   which are now returning an integer count of engines
                   and drivers, respectively, while the following
                   functions are now being introduced:
                     lscp_list_available_engines();
                     lscp_list_available_audio_drivers();
                     lscp_list_available_midi_drivers();
                   taking on the previous functionality, returning
                   a comma separated list of names.

0.2.7  2005-03-10  Mini bitsy regression; a severe crash (segfault)
                   was fixed on the device configuration functions:
                     lscp_set_audio_device_param();
                     lscp_set_midi_device_param();
                     lscp_set_audio_channel_param();
                     lscp_set_midi_port_param();

0.2.6  2005-03-01  Fixed nasty off-by-one bug on internal helpers.

0.2.5  2005-02-14  Added support for the new INSTRUMENT_NAME field
                   of GET CHANNEL INFO command.

0.2.4  2004-10-11  Fixed lscp_set_channel_midi_channel() again, MIDI
                   channels should be given in the range 0-15, and omni
                   mode with the LSCP_MIDI_CHANNEL_ALL symbol (16).

                   Fixed lscp_get_channel_info() to parse MIDI omni
                   (ALL) channels mode.

0.2.3  2004-09-28  Fixed lscp_set_channel_midi_channel() where MIDI
                   channels should be given in the range 1-16, and
                   omni mode with the new LSCP_MIDI_CHANNEL_ALL
                   symbol (0).

                   Rearrangement on main command requester executive.

0.2.2  2004-07-29  In sync with LSCP document draf (v.12).

                   New functions added: lscp_client_get_events() and
                   lscp_reset_sampler().

                   Added support for generating Debian packages;
                   renamed pkg-config lib name 'liblscp' -> 'lscp' as
                   it's common practice to omit the 'lib' prefix.

0.2.1  2004-07-09  Potential cripling defects habve been fixed.

0.2.0  2004-07-06  New LSCP extension draft (v.11) initial support.
                   (still a work in progress...)


0.1.9  2004-05-18  More fixes for MSVC++ example build.

0.1.8  2004-05-17  Fix for MSVC++ example build; snprintf replaced by
                   buffer overflow friendlier sprintf.

0.1.7  2004-05-10  Missing version.h now included on install; WIN32 is
                   only now conditionally defined.

0.1.6  2004-05-04  WIN32 build support; LPGL disclaimer consistency;
                   versioning functions introduced.

0.1.5  2004-04-26  Server stuff moved into examples.

0.1.4  2004-04-24  Initial auto/libtool preparation.
1	capela	103	liblscp - LinuxSampler Control Protocol API
2			-------------------------------------------
3
4			ChangeLog
5
6	capela	3842	0.9.0 2020-12-17 A Winter'20 release.
7
8	capela	3754	0.6.2 2019-03-24 A Spring'20 release.
9	schoenebeck	3663
10	capela	3754	Fixed compile errors on macOS.
11
12	schoenebeck	3664	Expose actual system error codes via client interface
13			instead of just -1 whenever a syscall failed.
14
15			Added new client interface function:
16			lscp_client_connection_lost();
17			for checking whether client lost connection to server.
18
19	schoenebeck	3666	Fixed potential missing NULL termination of locale strings.
20
21	capela	3670	0.6.1 2019-12-22 The Winter'19 Release.
22
23	capela	3400	0.6.0 2017-12-12 An Autumn'17 release.
24
25	capela	3043	0.5.8 2016-11-14 A Fall'16 release.
26
27	capela	2487	0.5.7 2013-12-31 Use getaddrinfo() instead of deprecated gethostbyname().
28	capela	1813
29	capela	2422	Update on newer autoconf macros (m4).
30
31	capela	2418	Fixes for building for Windows with configure and make.
32
33	persson	2132	Makefile fixes for building in separate directory.
34
35	schoenebeck	2454	Autoconf fix: AC_CONFIG_HEADER obsolete error (fixes #194).
36
37	persson	2132	0.5.6 2009-08-01 Fixed locale related parser bug (fixes #59).
38
39	capela	1813	Added new client interface functions, for managing
40			the global limit of maximum voices and disk streams:
41			lscp_get_voices(), lscp_set_voices(), lscp_get_streams(),
42			lscp_set_streams().
43
44			_lscp_device_port_info_query(): take port parameter
45	schoenebeck	1711	"NAME" into the result list.
46	schoenebeck	1692
47	schoenebeck	1711	Bugfix: _lscp_client_evt_proc() dropped LSCP events.
48
49	schoenebeck	1692	Bugfix in lscp_client_subscribe(): only the first
50	schoenebeck	1690	lscp_client_subscribe() call succeeded (per client),
51			all subsequent ones failed.
52
53			Added support for new (un)subscribable events:
54	schoenebeck	1689	LSCP_EVENT_CHANNEL_MIDI
55	schoenebeck	1697	LSCP_EVENT_DEVICE_MIDI
56	schoenebeck	1689	Caution: the bitflag approach for the event variable
57			is now abondoned, since otherwise we would soon hit the
58			limit of the bit range. The bitflag approach will
59			remain for events older at this point (that is all
60			events which occupy the lower 16 bits), but this new
61			and all following events will simply be enumared along
62			the upper 16 bits.
63
64			Added new client interface function, for renaming
65	schoenebeck	1665	effect send entities:
66			lscp_set_fxsend_name();
67
68	schoenebeck	1802	Added new client interface functions, for managing the
69			global limit of maximum voices and disk streams:
70			lscp_get_voices();
71			lscp_set_voices();
72			lscp_get_streams();
73			lscp_set_streams();
74
75	schoenebeck	1806	Bugfix: fixed buggy behavior on different locale
76			settings (e.g. when parsing floating point numbers).
77
78	capela	1412	0.5.5 2007-10-12 Changed client interface function, for editing
79			instrument, from:
80			lscp_edit_instrument();
81			to:
82			lscp_edit_channel_instrument();
83
84	capela	1368	0.5.4 2007-10-02 Added new client interface function, for editing
85	schoenebeck	1365	instrument:
86			lscp_edit_instrument();
87
88			Fixed some minor bugs in:
89			lscp_set_fxsend_midi_controller();
90			lscp_set_fxsend_level();
91
92	capela	1031	0.5.3 2007-01-15 Added new client interface functions, for sampler
93			channel effect sends control:
94			lscp_set_fxsend_midi_controller();
95			lscp_set_fxsend_level();
96
97			Added new field member to lscp_fxsend_info_t (level).
98
99	capela	1019	0.5.2 2007-01-11 Added new client interface functions, for sampler
100			channel effect sends control:
101			lscp_create_fxsend();
102			lscp_destroy_fxsend();
103			lscp_get_fxsends();
104			lscp_list_fxsends();
105			lscp_get_fxsend_info();
106			lscp_set_fxsend_audio_channel();
107	capela	1369	and for global volume:
108	capela	1019	lscp_get_volume();
109			lscp_set_volume();
110
111	capela	1031	Audio routing representation changed to integer array.
112	capela	1020
113	capela	997	0.5.1 2006-12-22 Added support for new (un)subscribable events:
114	capela	994	LSCP_EVENT_AUDIO_OUTPUT_DEVICE_COUNT,
115			LSCP_EVENT_AUDIO_OUTPUT_DEVICE_INFO,
116			LSCP_EVENT_MIDI_INPUT_DEVICE_COUNT,
117			LSCP_EVENT_MIDI_INPUT_DEVICE_INFO,
118			LSCP_EVENT_MIDI_INSTRUMENT_MAP_COUNT,
119			LSCP_EVENT_MIDI_INSTRUMENT_MAP_INFO,
120			LSCP_EVENT_MIDI_INSTRUMENT_COUNT,
121			LSCP_EVENT_MIDI_INSTRUMENT_INFO.
122	schoenebeck	1802
123	capela	994	Updated examples.
124	capela	983
125	capela	975	0.5.0 2006-12-17 MIDI instrument mapping, second round, according to
126			LSCP 1.2 draft document as of December 15, 2006.
127
128			New client interface functions:
129			lscp_set_channel_midi_map();
130			lscp_add_midi_instrument_map();
131			lscp_remove_midi_instrument_map();
132			lscp_get_midi_instrument_maps();
133			lscp_list_midi_instrument_maps();
134			lscp_get_midi_instrument_map_name();
135			lscp_set_midi_instrument_map_name();
136
137
138	capela	965	0.4.2 2006-12-04 MIDI instrument mapping fixed, previously missing
139	capela	963	the regular ON_DEMAND load mode.
140
141			Server error reporting is now effective; all server
142			numerical error and warning codes are added to 100,
143			thus giving a proper non-zero lscp_client_get_errno()
144			return value.
145
146	capela	948	0.4.1 2006-11-28 Fixed the flush timeout operation to be issued only
147			once, avoiding recurrent client failure after receive
148			timeout.
149
150			Support for very long command result sets have been
151			introduced, with the downside of strictly obeying
152			the LSCP draft.
153
154			list_midi_instruments() is now being implemented.
155
156			LGPL text is now back in COPYING.
157
158	capela	946	0.4.0 2006-11-27 As of the LSCP 1.2 working draft document, added
159			some missing client interface functions:
160			lscp_get_total_voice_count();
161			lscp_get_total_voice_count_max();
162			and for the new MIDI instrumenbt mapping features:
163			lscp_map_midi_instrument();
164			lscp_unmap_midi_instrument();
165			lscp_get_midi_instruments();
166			lscp_get_midi_instrument_info();
167			lscp_clear_midi_instruments();
168
169
170	capela	921	0.3.4 2006-09-24 GPL address update.
171
172	capela	869	0.3.3 2006-06-01 Fixed some compilation warnings due to suspicious type
173			casting and unsused header macros.
174
175			Changed deprecated copyright attribute to license
176			and added ldconfig to post-(un)install steps
177			to liblscp.spec (RPM).
178
179	capela	764	0.3.2 2005-08-29 Fixed missing initialization bug on lscp_channel_info_t
180	capela	749	new struct fields (mute/solo).
181
182			Include debian files into distribution.
183
184	capela	754	Renamed configure.in to newer configure.ac.
185
186	capela	735	0.3.1 2005-08-16 [bug #21] Fixed automake support for separate build
187	capela	712	directory.
188	capela	749
189	capela	735	Added support to sampler channel MUTE/SOLO states:
190			lscp_set_channel_mute();
191			lscp_set_channel_solo();
192			with corresponding new lscp_channel_info_t fields.
193	capela	712
194	capela	626	0.3.0 2005-06-10 [bug #11] Timeout flush idiosyncrasy is now a feature;
195	capela	623	this just tries to flush the receive buffer whenever
196			any previous transaction has failed due to a timeout.
197
198	capela	626	Fixed an off-by-one timeout quirk, that has been a real
199			showstopper on Mac OS X at least, which is incidental
200			to qsampler's default timeout setting of 1000 msecs,
201			giving up systematically on select() due to "Invalid
202			argument" (EINVAL).
203
204	capela	946
205	capela	562	0.2.8 2005-05-22 More LSCP command syntax changes, particularly on the
206			event subscription ones: the LSCP_EVENT_CHANNELS event
207			definition were renamed to LSCP_EVENT_CHANNEL_COUNT,
208	capela	564	as to be more meaningful. Added support for the newest
209			LSCP command: GET SERVER INFO; lscp_get_server_info().
210	capela	562
211	schoenebeck	1802	0.2.8 2005-05-08 [bug #9] Fixed for a LSCP command syntax convention
212			consistency, regarding the enumeration of available
213			sampler engines, Audio and MIDI drivers; this has
214	capela	523	affected the signature of the following functions:
215			lscp_get_available_engines();
216			lscp_get_available_audio_drivers();
217			lscp_get_available_midi_drivers();
218			which are now returning an integer count of engines
219	schoenebeck	1802	and drivers, respectively, while the following
220	capela	523	functions are now being introduced:
221			lscp_list_available_engines();
222			lscp_list_available_audio_drivers();
223			lscp_list_available_midi_drivers();
224			taking on the previous functionality, returning
225			a comma separated list of names.
226
227	capela	445	0.2.7 2005-03-10 Mini bitsy regression; a severe crash (segfault)
228	capela	435	was fixed on the device configuration functions:
229			lscp_set_audio_device_param();
230			lscp_set_midi_device_param();
231			lscp_set_audio_channel_param();
232			lscp_set_midi_port_param();
233	capela	419
234	capela	415	0.2.6 2005-03-01 Fixed nasty off-by-one bug on internal helpers.
235
236	capela	380	0.2.5 2005-02-14 Added support for the new INSTRUMENT_NAME field
237	capela	378	of GET CHANNEL INFO command.
238
239	capela	278	0.2.4 2004-10-11 Fixed lscp_set_channel_midi_channel() again, MIDI
240			channels should be given in the range 0-15, and omni
241			mode with the LSCP_MIDI_CHANNEL_ALL symbol (16).
242	capela	415
243	capela	279	Fixed lscp_get_channel_info() to parse MIDI omni
244			(ALL) channels mode.
245	capela	278
246	capela	257	0.2.3 2004-09-28 Fixed lscp_set_channel_midi_channel() where MIDI
247			channels should be given in the range 1-16, and
248			omni mode with the new LSCP_MIDI_CHANNEL_ALL
249			symbol (0).
250	capela	415
251	capela	253	Rearrangement on main command requester executive.
252
253	capela	213	0.2.2 2004-07-29 In sync with LSCP document draf (v.12).
254
255			New functions added: lscp_client_get_events() and
256			lscp_reset_sampler().
257
258			Added support for generating Debian packages;
259	schoenebeck	199	renamed pkg-config lib name 'liblscp' -> 'lscp' as
260			it's common practice to omit the 'lib' prefix.
261
262	capela	194	0.2.1 2004-07-09 Potential cripling defects habve been fixed.
263	capela	187
264	capela	178	0.2.0 2004-07-06 New LSCP extension draft (v.11) initial support.
265	capela	103	(still a work in progress...)
266
267	capela	946
268	capela	103	0.1.9 2004-05-18 More fixes for MSVC++ example build.
269
270			0.1.8 2004-05-17 Fix for MSVC++ example build; snprintf replaced by
271			buffer overflow friendlier sprintf.
272
273			0.1.7 2004-05-10 Missing version.h now included on install; WIN32 is
274			only now conditionally defined.
275
276			0.1.6 2004-05-04 WIN32 build support; LPGL disclaimer consistency;
277			versioning functions introduced.
278
279			0.1.5 2004-04-26 Server stuff moved into examples.
280
281			0.1.4 2004-04-24 Initial auto/libtool preparation.