Don't inline the utf8 converters
[openal-soft.git] / ChangeLog
blobedef433122971723390180b5e96da3fb74aaf1f8
1 openal-soft-1.20.0:
3     Converted the library codebase to C++11. A lot of hacks and custom
4     structures have been replaced with standard or cleaner implementations.
6     Partially implemented the Vocal Morpher effect.
8     Fixed the bsinc SSE resamplers on non-GCC compilers.
10     Fixed OpenSL capture.
12     Fixed support for extended capture formats with OpenSL.
14     Fixed handling of WASAPI not reporting a default device.
16     Fixed performance problems relating to semaphores on macOS.
18     Modified the bsinc12 resampler's transition band to better avoid aliasing
19     noise.
21     Modified alcResetDeviceSOFT to attempt recovery of disconnected devices.
23     Modified the virtual speaker layout for HRTF B-Format decoding.
25     Modified the PulseAudio backend to use a custom processing loop.
27     Renamed the makehrtf utility to makemhr.
29     Improved the efficiency of the bsinc resamplers when up-sampling.
31     Improved the quality of the bsinc resamplers slightly.
33     Improved the efficiency of the HRTF mixers.
35     Improved the HRTF B-Format decoder coefficient generation.
37     Improved reverb fading to be more consistent with pan fading.
39     Improved handling of sources that end prematurely, to avoid loud clicks.
41     Improved the performance of some reverb processing loops.
43     Added fast_bsinc resamplers that improve efficiency at the cost of some
44     quality. Notably, when down-sampling with pitch ramping.
46     Added support for SOFA input files with makemhr.
48     Added a build option to use pre-built native tools. For cross-compiling,
49     use with caution and ensure the native tools' binaries are kept up-to-date.
51     Added an adjust-latency config option for the PulseAudio backend.
53     Added basic support for multi-field HRTFs.
55     Added an option for mixing first-, second-, or third-order B-Format with
56     HRTF output. This can improve HRTF performance given a number of sources.
58     Added an RC file for proper DLL version information.
60     Disabled some old KDE workarounds by default. Specifically, PulseAudio
61     streams can now be moved (KDE may try to move them after opening).
63 openal-soft-1.19.1:
65     Implemented capture support for the SoundIO backend.
67     Fixed source buffer queues potentially not playing properly when a queue
68     entry completes.
70     Fixed possible unexpected failures when generating auxiliary effect slots.
72     Fixed a crash with certain reverb or device settings.
74     Fixed OpenSL capture.
76     Improved output limiter response, better ensuring the sample amplitude is
77     clamped for output.
79 openal-soft-1.19.0:
81     Implemented the ALC_SOFT_device_clock extension.
83     Implemented the Pitch Shifter, Frequency Shifter, and Autowah effects.
85     Fixed compiling on FreeBSD systems that use freebsd-lib 9.1.
87     Fixed compiling on NetBSD.
89     Fixed the reverb effect's density scale and panning parameters.
91     Fixed use of the WASAPI backend with certain games, which caused odd COM
92     initialization errors.
94     Increased the number of virtual channels for decoding Ambisonics to HRTF
95     output.
97     Changed 32-bit x86 builds to use SSE2 math by default for performance.
98     Build-time options are available to use just SSE1 or x87 instead.
100     Replaced the 4-point Sinc resampler with a more efficient cubic resampler.
102     Renamed the MMDevAPI backend to WASAPI.
104     Added support for 24-bit, dual-ear HRTF data sets. The built-in data set
105     has been updated to 24-bit.
107     Added a 24- to 48-point band-limited Sinc resampler.
109     Added an SDL2 playback backend. Disabled by default to avoid a dependency
110     on SDL2.
112     Improved the performance and quality of the Chorus and Flanger effects.
114     Improved the efficiency of the band-limited Sinc resampler.
116     Improved the Sinc resampler's transition band to avoid over-attenuating
117     higher frequencies.
119     Improved the performance of some filter operations.
121     Improved the efficiency of object ID lookups.
123     Improved the efficienty of internal voice/source synchronization.
125     Improved AL call error logging with contextualized messages.
127     Removed the reverb effect's modulation stage. Due to the lack of reference
128     for its intended behavior and strength.
130 openal-soft-1.18.2:
132     Fixed resetting the FPU rounding mode after certain function calls on
133     Windows.
135     Fixed use of SSE intrinsics when building with Clang on Windows.
137     Fixed a crash with the JACK backend when using JACK1.
139     Fixed use of pthread_setnane_np on NetBSD.
141     Fixed building on FreeBSD with an older freebsd-lib.
143     OSS now links with libossaudio if found at build time (for NetBSD).
145 openal-soft-1.18.1:
147     Fixed an issue where resuming a source might not restart playing it.
149     Fixed PulseAudio playback when the configured stream length is much less
150     than the requested length.
152     Fixed MMDevAPI capture with sample rates not matching the backing device.
154     Fixed int32 output for the Wave Writer.
156     Fixed enumeration of OSS devices that are missing device files.
158     Added correct retrieval of the executable's path on FreeBSD.
160     Added a config option to specify the dithering depth.
162     Added a 5.1 decoder preset that excludes front-center output.
164 openal-soft-1.18.0:
166     Implemented the AL_EXT_STEREO_ANGLES and AL_EXT_SOURCE_RADIUS extensions.
168     Implemented the AL_SOFT_gain_clamp_ex, AL_SOFT_source_resampler,
169     AL_SOFT_source_spatialize, and ALC_SOFT_output_limiter extensions.
171     Implemented 3D processing for some effects. Currently implemented for
172     Reverb, Compressor, Equalizer, and Ring Modulator.
174     Implemented 2-channel UHJ output encoding. This needs to be enabled with a
175     config option to be used.
177     Implemented dual-band processing for high-quality ambisonic decoding.
179     Implemented distance-compensation for surround sound output.
181     Implemented near-field emulation and compensation with ambisonic rendering.
182     Currently only applies when using the high-quality ambisonic decoder or
183     ambisonic output, with appropriate config options.
185     Implemented an output limiter to reduce the amount of distortion from
186     clipping.
188     Implemented dithering for 8-bit and 16-bit output.
190     Implemented a config option to select a preferred HRTF.
192     Implemented a run-time check for NEON extensions using /proc/cpuinfo.
194     Implemented experimental capture support for the OpenSL backend.
196     Fixed building on compilers with NEON support but don't default to having
197     NEON enabled.
199     Fixed support for JACK on Windows.
201     Fixed starting a source while alcSuspendContext is in effect.
203     Fixed detection of headsets as headphones, with MMDevAPI.
205     Added support for AmbDec config files, for custom ambisonic decoder
206     configurations. Version 3 files only.
208     Added backend-specific options to alsoft-config.
210     Added first-, second-, and third-order ambisonic output formats. Currently
211     only works with backends that don't rely on channel labels, like JACK,
212     ALSA, and OSS.
214     Added a build option to embed the default HRTFs into the lib.
216     Added AmbDec presets to enable high-quality ambisonic decoding.
218     Added an AmbDec preset for 3D7.1 speaker setups.
220     Added documentation regarding Ambisonics, 3D7.1, AmbDec config files, and
221     the provided ambdec presets.
223     Added the ability for MMDevAPI to open devices given a Device ID or GUID
224     string.
226     Added an option to the example apps to open a specific device.
228     Increased the maximum auxiliary send limit to 16 (up from 4). Requires
229     requesting them with the ALC_MAX_AUXILIARY_SENDS context creation
230     attribute.
232     Increased the default auxiliary effect slot count to 64 (up from 4).
234     Reduced the default period count to 3 (down from 4).
236     Slightly improved automatic naming for enumerated HRTFs.
238     Improved B-Format decoding with HRTF output.
240     Improved internal property handling for better batching behavior.
242     Improved performance of certain filter uses.
244     Removed support for the AL_SOFT_buffer_samples and AL_SOFT_buffer_sub_data
245     extensions. Due to conflicts with AL_EXT_SOURCE_RADIUS.
247 openal-soft-1.17.2:
249     Implemented device enumeration for OSSv4.
251     Fixed building on OSX.
253     Fixed building on non-Windows systems without POSIX-2008.
255     Fixed Dedicated Dialog and Dedicated LFE effect output.
257     Added a build option to override the share install dir.
259     Added a build option to static-link libgcc for MinGW.
261 openal-soft-1.17.1:
263     Fixed building with JACK and without PulseAudio.
265     Fixed building on FreeBSD.
267     Fixed the ALSA backend's allow-resampler option.
269     Fixed handling of inexact ALSA period counts.
271     Altered device naming scheme on Windows backends to better match other
272     drivers.
274     Updated the CoreAudio backend to use the AudioComponent API. This clears up
275     deprecation warnings for OSX 10.11, although requires OSX 10.6 or newer.
277 openal-soft-1.17.0:
279     Implemented a JACK playback backend.
281     Implemented the AL_EXT_BFORMAT and AL_EXT_MULAW_BFORMAT extensions.
283     Implemented the ALC_SOFT_HRTF extension.
285     Implemented C, SSE3, and SSE4.1 based 4- and 8-point Sinc resamplers.
287     Implemented a C and SSE based band-limited Sinc resampler. This does 12- to
288     24-point Sinc resampling, and performs anti-aliasing.
290     Implemented B-Format output support for the wave file writer. This creates
291     FuMa-style first-order Ambisonics wave files (AMB format).
293     Implemented a stereo-mode config option for treating stereo modes as either
294     speakers or headphones.
296     Implemented per-device configuration options.
298     Fixed handling of PulseAudio and MMDevAPI devices that have identical
299     descriptions.
301     Fixed a potential lockup when stopping playback of suspended PulseAudio devices.
303     Fixed logging of Unicode characters on Windows.
305     Fixed 5.1 surround sound channels. By default it will now use the side
306     channels for the surround output. A configuration using rear channels is
307     still available.
309     Fixed the QSA backend potentially altering the capture format.
311     Fixed detecting MMDevAPI's default device.
313     Fixed returning the default capture device name.
315     Fixed mixing property calculations when deferring context updates.
317     Altered the behavior of alcSuspendContext and alcProcessContext to better
318     match certain Windows drivers.
320     Altered the panning algorithm, utilizing Ambisonics for better side and
321     back positioning cues with surround sound output.
323     Improved support for certain older Windows apps.
325     Improved the alffplay example to support surround sound streams.
327     Improved support for building as a sub-project.
329     Added an HRTF playback example.
331     Added a tone generator output test.
333     Added a toolchain to help with cross-compiling to Android.
335 openal-soft-1.16.0:
337     Implemented EFX Chorus, Flanger, Distortion, Equalizer, and Compressor
338     effects.
340     Implemented high-pass and band-pass EFX filters.
342     Implemented the high-pass filter for the EAXReverb effect.
344     Implemented SSE2 and SSE4.1 linear resamplers.
346     Implemented Neon-enhanced non-HRTF mixers.
348     Implemented a QSA backend, for QNX.
350     Implemented the ALC_SOFT_pause_device, AL_SOFT_deferred_updates,
351     AL_SOFT_block_alignment, AL_SOFT_MSADPCM, and AL_SOFT_source_length
352     extensions.
354     Fixed resetting mmdevapi backend devices.
356     Fixed clamping when converting 32-bit float samples to integer.
358     Fixed modulation range in the Modulator effect.
360     Several fixes for the OpenSL playback backend.
362     Fixed device specifier names that have Unicode characters on Windows.
364     Added support for filenames and paths with Unicode (UTF-8) characters on
365     Windows.
367     Added support for alsoft.conf config files found in XDG Base Directory
368     Specification locations (XDG_CONFIG_DIRS and XDG_CONFIG_HOME, or their
369     defaults) on non-Windows systems.
371     Added a GUI configuration utility (requires Qt 4.8).
373     Added support for environment variable expansion in config options (not
374     keys or section names).
376     Added an example that uses SDL2 and ffmpeg.
378     Modified examples to use SDL_sound.
380     Modified CMake config option names for better sorting.
382     HRTF data sets specified in the hrtf_tables config option may now be
383     relative or absolute filenames.
385     Made the default HRTF data set an external file, and added a data set for
386     48khz playback in addition to 44.1khz.
388     Added support for C11 atomic methods.
390     Improved support for some non-GNU build systems.
392 openal-soft-1.15.1:
394     Fixed a regression with retrieving the source's AL_GAIN property.
396 openal-soft-1.15:
398     Fixed device enumeration with the OSS backend.
400     Reorganized internal mixing logic, so unneeded steps can potentially be
401     skipped for better performance.
403     Removed the lookup table for calculating the mixing pans. The panning is
404     now calculated directly for better precision.
406     Improved the panning of stereo source channels when using stereo output.
408     Improved source filter quality on send paths.
410     Added a config option to allow PulseAudio to move streams between devices.
412     The PulseAudio backend will now attempt to spawn a server by default.
414     Added a workaround for a DirectSound bug relating to float32 output.
416     Added SSE-based mixers, for HRTF and non-HRTF mixing.
418     Added support for the new AL_SOFT_source_latency extension.
420     Improved ALSA capture by avoiding an extra buffer when using sizes
421     supported by the underlying device.
423     Improved the makehrtf utility to support new options and input formats.
425     Modified the CFLAGS declared in the pkg-config file so the "AL/" portion of
426     the header includes can optionally be omitted.
428     Added a couple example code programs to show how to apply reverb, and
429     retrieve latency.
431     The configuration sample is now installed into the share/openal/ directory
432     instead of /etc/openal.
434     The configuration sample now gets installed by default.