Annotation of /liblscp/trunk/ChangeLog

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

ChangeLog

0.9.8  2022-12-28  An End-of-Year'22 release.

                   Fixed broken pkg-config file (lscp.pc) generation (thanks
                   to Konstantin Voinov while on OBS multimedia::proaudio).

0.9.7  2022-10-03  An Early-Autumn'22 release.

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