Annotation of /liblscp/trunk/ChangeLog

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

ChangeLog

0.9.6  2022-04-02  Install doxygen (doc/html) files again (via cmake).

0.9.5  2022-01-09  Dropped autotools (autoconf, automake, etc.) build system.

0.9.4  2021-07-04  An Early-Summer'21 release.

0.9.3  2021-05-11  A Spring'21 release.

                   Introducing cmake build option.

0.9.2  2021-03-14  An End-of-Winter'21 release.

0.9.1  2021-02-07  A Winter'21 release.

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