Avoid extraneous parameters
[openal-soft.git] / ChangeLog
blobdd491ff043a16cac9219666e4eb11ebe2846fd8f
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 resampler 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 alcResetDeviceSOFT to attempt recovery of lost devices.
20     Modified the virtual speaker layout for HRTF B-Format decoding.
22     Modified the PulseAudio backend to use a custom processing loop.
24     Renamed the makehrtf utility to makemhr.
26     Improved the efficiency of the HRTF mixers.
28     Improved the HRTF B-Format decoder coefficient generation.
30     Improved reverb fading to be more consistent with pan fading.
32     Improved handling of sources that end prematurely, to avoid loud clicks.
34     Improved some reverb processing loops.
36     Added support for SOFA input files with makemhr.
38     Added a build option to use pre-built native tools. For cross-compiling,
39     use with caution and ensure the native tools' binaries are kept up-to-date.
41     Added an adjust-latency config option for the PulseAudio backend.
43     Added basic support for multi-field HRTFs.
45     Added an option for mixing first-, second-, or third-order B-Format with
46     HRTF output. This can improve HRTF performance given a number of sources.
48     Added an RC file for proper DLL version information.
50     Disabled some old KDE workarounds by default. Specifically, PulseAudio
51     streams can now be moved (KDE may try to move them after opening).
53 openal-soft-1.19.1:
55     Implemented capture support for the SoundIO backend.
57     Fixed source buffer queues potentially not playing properly when a queue
58     entry completes.
60     Fixed possible unexpected failures when generating auxiliary effect slots.
62     Fixed a crash with certain reverb or device settings.
64     Fixed OpenSL capture.
66     Improved output limiter response, better ensuring the sample amplitude is
67     clamped for output.
69 openal-soft-1.19.0:
71     Implemented the ALC_SOFT_device_clock extension.
73     Implemented the Pitch Shifter, Frequency Shifter, and Autowah effects.
75     Fixed compiling on FreeBSD systems that use freebsd-lib 9.1.
77     Fixed compiling on NetBSD.
79     Fixed the reverb effect's density scale and panning parameters.
81     Fixed use of the WASAPI backend with certain games, which caused odd COM
82     initialization errors.
84     Increased the number of virtual channels for decoding Ambisonics to HRTF
85     output.
87     Changed 32-bit x86 builds to use SSE2 math by default for performance.
88     Build-time options are available to use just SSE1 or x87 instead.
90     Replaced the 4-point Sinc resampler with a more efficient cubic resampler.
92     Renamed the MMDevAPI backend to WASAPI.
94     Added support for 24-bit, dual-ear HRTF data sets. The built-in data set
95     has been updated to 24-bit.
97     Added a 24- to 48-point band-limited Sinc resampler.
99     Added an SDL2 playback backend. Disabled by default to avoid a dependency
100     on SDL2.
102     Improved the performance and quality of the Chorus and Flanger effects.
104     Improved the efficiency of the band-limited Sinc resampler.
106     Improved the Sinc resampler's transition band to avoid over-attenuating
107     higher frequencies.
109     Improved the performance of some filter operations.
111     Improved the efficiency of object ID lookups.
113     Improved the efficienty of internal voice/source synchronization.
115     Improved AL call error logging with contextualized messages.
117     Removed the reverb effect's modulation stage. Due to the lack of reference
118     for its intended behavior and strength.
120 openal-soft-1.18.2:
122     Fixed resetting the FPU rounding mode after certain function calls on
123     Windows.
125     Fixed use of SSE intrinsics when building with Clang on Windows.
127     Fixed a crash with the JACK backend when using JACK1.
129     Fixed use of pthread_setnane_np on NetBSD.
131     Fixed building on FreeBSD with an older freebsd-lib.
133     OSS now links with libossaudio if found at build time (for NetBSD).
135 openal-soft-1.18.1:
137     Fixed an issue where resuming a source might not restart playing it.
139     Fixed PulseAudio playback when the configured stream length is much less
140     than the requested length.
142     Fixed MMDevAPI capture with sample rates not matching the backing device.
144     Fixed int32 output for the Wave Writer.
146     Fixed enumeration of OSS devices that are missing device files.
148     Added correct retrieval of the executable's path on FreeBSD.
150     Added a config option to specify the dithering depth.
152     Added a 5.1 decoder preset that excludes front-center output.
154 openal-soft-1.18.0:
156     Implemented the AL_EXT_STEREO_ANGLES and AL_EXT_SOURCE_RADIUS extensions.
158     Implemented the AL_SOFT_gain_clamp_ex, AL_SOFT_source_resampler,
159     AL_SOFT_source_spatialize, and ALC_SOFT_output_limiter extensions.
161     Implemented 3D processing for some effects. Currently implemented for
162     Reverb, Compressor, Equalizer, and Ring Modulator.
164     Implemented 2-channel UHJ output encoding. This needs to be enabled with a
165     config option to be used.
167     Implemented dual-band processing for high-quality ambisonic decoding.
169     Implemented distance-compensation for surround sound output.
171     Implemented near-field emulation and compensation with ambisonic rendering.
172     Currently only applies when using the high-quality ambisonic decoder or
173     ambisonic output, with appropriate config options.
175     Implemented an output limiter to reduce the amount of distortion from
176     clipping.
178     Implemented dithering for 8-bit and 16-bit output.
180     Implemented a config option to select a preferred HRTF.
182     Implemented a run-time check for NEON extensions using /proc/cpuinfo.
184     Implemented experimental capture support for the OpenSL backend.
186     Fixed building on compilers with NEON support but don't default to having
187     NEON enabled.
189     Fixed support for JACK on Windows.
191     Fixed starting a source while alcSuspendContext is in effect.
193     Fixed detection of headsets as headphones, with MMDevAPI.
195     Added support for AmbDec config files, for custom ambisonic decoder
196     configurations. Version 3 files only.
198     Added backend-specific options to alsoft-config.
200     Added first-, second-, and third-order ambisonic output formats. Currently
201     only works with backends that don't rely on channel labels, like JACK,
202     ALSA, and OSS.
204     Added a build option to embed the default HRTFs into the lib.
206     Added AmbDec presets to enable high-quality ambisonic decoding.
208     Added an AmbDec preset for 3D7.1 speaker setups.
210     Added documentation regarding Ambisonics, 3D7.1, AmbDec config files, and
211     the provided ambdec presets.
213     Added the ability for MMDevAPI to open devices given a Device ID or GUID
214     string.
216     Added an option to the example apps to open a specific device.
218     Increased the maximum auxiliary send limit to 16 (up from 4). Requires
219     requesting them with the ALC_MAX_AUXILIARY_SENDS context creation
220     attribute.
222     Increased the default auxiliary effect slot count to 64 (up from 4).
224     Reduced the default period count to 3 (down from 4).
226     Slightly improved automatic naming for enumerated HRTFs.
228     Improved B-Format decoding with HRTF output.
230     Improved internal property handling for better batching behavior.
232     Improved performance of certain filter uses.
234     Removed support for the AL_SOFT_buffer_samples and AL_SOFT_buffer_sub_data
235     extensions. Due to conflicts with AL_EXT_SOURCE_RADIUS.
237 openal-soft-1.17.2:
239     Implemented device enumeration for OSSv4.
241     Fixed building on OSX.
243     Fixed building on non-Windows systems without POSIX-2008.
245     Fixed Dedicated Dialog and Dedicated LFE effect output.
247     Added a build option to override the share install dir.
249     Added a build option to static-link libgcc for MinGW.
251 openal-soft-1.17.1:
253     Fixed building with JACK and without PulseAudio.
255     Fixed building on FreeBSD.
257     Fixed the ALSA backend's allow-resampler option.
259     Fixed handling of inexact ALSA period counts.
261     Altered device naming scheme on Windows backends to better match other
262     drivers.
264     Updated the CoreAudio backend to use the AudioComponent API. This clears up
265     deprecation warnings for OSX 10.11, although requires OSX 10.6 or newer.
267 openal-soft-1.17.0:
269     Implemented a JACK playback backend.
271     Implemented the AL_EXT_BFORMAT and AL_EXT_MULAW_BFORMAT extensions.
273     Implemented the ALC_SOFT_HRTF extension.
275     Implemented C, SSE3, and SSE4.1 based 4- and 8-point Sinc resamplers.
277     Implemented a C and SSE based band-limited Sinc resampler. This does 12- to
278     24-point Sinc resampling, and performs anti-aliasing.
280     Implemented B-Format output support for the wave file writer. This creates
281     FuMa-style first-order Ambisonics wave files (AMB format).
283     Implemented a stereo-mode config option for treating stereo modes as either
284     speakers or headphones.
286     Implemented per-device configuration options.
288     Fixed handling of PulseAudio and MMDevAPI devices that have identical
289     descriptions.
291     Fixed a potential lockup when stopping playback of suspended PulseAudio devices.
293     Fixed logging of Unicode characters on Windows.
295     Fixed 5.1 surround sound channels. By default it will now use the side
296     channels for the surround output. A configuration using rear channels is
297     still available.
299     Fixed the QSA backend potentially altering the capture format.
301     Fixed detecting MMDevAPI's default device.
303     Fixed returning the default capture device name.
305     Fixed mixing property calculations when deferring context updates.
307     Altered the behavior of alcSuspendContext and alcProcessContext to better
308     match certain Windows drivers.
310     Altered the panning algorithm, utilizing Ambisonics for better side and
311     back positioning cues with surround sound output.
313     Improved support for certain older Windows apps.
315     Improved the alffplay example to support surround sound streams.
317     Improved support for building as a sub-project.
319     Added an HRTF playback example.
321     Added a tone generator output test.
323     Added a toolchain to help with cross-compiling to Android.
325 openal-soft-1.16.0:
327     Implemented EFX Chorus, Flanger, Distortion, Equalizer, and Compressor
328     effects.
330     Implemented high-pass and band-pass EFX filters.
332     Implemented the high-pass filter for the EAXReverb effect.
334     Implemented SSE2 and SSE4.1 linear resamplers.
336     Implemented Neon-enhanced non-HRTF mixers.
338     Implemented a QSA backend, for QNX.
340     Implemented the ALC_SOFT_pause_device, AL_SOFT_deferred_updates,
341     AL_SOFT_block_alignment, AL_SOFT_MSADPCM, and AL_SOFT_source_length
342     extensions.
344     Fixed resetting mmdevapi backend devices.
346     Fixed clamping when converting 32-bit float samples to integer.
348     Fixed modulation range in the Modulator effect.
350     Several fixes for the OpenSL playback backend.
352     Fixed device specifier names that have Unicode characters on Windows.
354     Added support for filenames and paths with Unicode (UTF-8) characters on
355     Windows.
357     Added support for alsoft.conf config files found in XDG Base Directory
358     Specification locations (XDG_CONFIG_DIRS and XDG_CONFIG_HOME, or their
359     defaults) on non-Windows systems.
361     Added a GUI configuration utility (requires Qt 4.8).
363     Added support for environment variable expansion in config options (not
364     keys or section names).
366     Added an example that uses SDL2 and ffmpeg.
368     Modified examples to use SDL_sound.
370     Modified CMake config option names for better sorting.
372     HRTF data sets specified in the hrtf_tables config option may now be
373     relative or absolute filenames.
375     Made the default HRTF data set an external file, and added a data set for
376     48khz playback in addition to 44.1khz.
378     Added support for C11 atomic methods.
380     Improved support for some non-GNU build systems.
382 openal-soft-1.15.1:
384     Fixed a regression with retrieving the source's AL_GAIN property.
386 openal-soft-1.15:
388     Fixed device enumeration with the OSS backend.
390     Reorganized internal mixing logic, so unneeded steps can potentially be
391     skipped for better performance.
393     Removed the lookup table for calculating the mixing pans. The panning is
394     now calculated directly for better precision.
396     Improved the panning of stereo source channels when using stereo output.
398     Improved source filter quality on send paths.
400     Added a config option to allow PulseAudio to move streams between devices.
402     The PulseAudio backend will now attempt to spawn a server by default.
404     Added a workaround for a DirectSound bug relating to float32 output.
406     Added SSE-based mixers, for HRTF and non-HRTF mixing.
408     Added support for the new AL_SOFT_source_latency extension.
410     Improved ALSA capture by avoiding an extra buffer when using sizes
411     supported by the underlying device.
413     Improved the makehrtf utility to support new options and input formats.
415     Modified the CFLAGS declared in the pkg-config file so the "AL/" portion of
416     the header includes can optionally be omitted.
418     Added a couple example code programs to show how to apply reverb, and
419     retrieve latency.
421     The configuration sample is now installed into the share/openal/ directory
422     instead of /etc/openal.
424     The configuration sample now gets installed by default.