Handle the ALC version for some extension capabilities
[openal-soft.git] / ChangeLog
blob84dac8698e5764fc6f2a799ec0d512e8f080cba2
1 openal-soft-1.18.1:
3     Fixed an issue where resuming a source might not restart playing it.
5     Fixed PulseAudio playback when the configured stream length is much less
6     than the requested length.
8     Fixed MMDevAPI capture with sample rates not matching the backing device.
10     Added correct retrieval of the executable's path on FreeBSD.
12     Added a config option to specify the dithering depth.
14 openal-soft-1.18.0:
16     Implemented the AL_EXT_STEREO_ANGLES and AL_EXT_SOURCE_RADIUS extensions.
18     Implemented the AL_SOFT_gain_clamp_ex, AL_SOFT_source_resampler,
19     AL_SOFT_source_spatialize, and ALC_SOFT_output_limiter extensions.
21     Implemented 3D processing for some effects. Currently implemented for
22     Reverb, Compressor, Equalizer, and Ring Modulator.
24     Implemented 2-channel UHJ output encoding. This needs to be enabled with a
25     config option to be used.
27     Implemented dual-band processing for high-quality ambisonic decoding.
29     Implemented distance-compensation for surround sound output.
31     Implemented near-field emulation and compensation with ambisonic rendering.
32     Currently only applies when using the high-quality ambisonic decoder or
33     ambisonic output, with appropriate config options.
35     Implemented an output limiter to reduce the amount of distortion from
36     clipping.
38     Implemented dithering for 8-bit and 16-bit output.
40     Implemented a config option to select a preferred HRTF.
42     Implemented a run-time check for NEON extensions using /proc/cpuinfo.
44     Implemented experimental capture support for the OpenSL backend.
46     Fixed building on compilers with NEON support but don't default to having
47     NEON enabled.
49     Fixed support for JACK on Windows.
51     Fixed starting a source while alcSuspendContext is in effect.
53     Fixed detection of headsets as headphones, with MMDevAPI.
55     Added support for AmbDec config files, for custom ambisonic decoder
56     configurations. Version 3 files only.
58     Added backend-specific options to alsoft-config.
60     Added first-, second-, and third-order ambisonic output formats. Currently
61     only works with backends that don't rely on channel labels, like JACK,
62     ALSA, and OSS.
64     Added a build option to embed the default HRTFs into the lib.
66     Added AmbDec presets to enable high-quality ambisonic decoding.
68     Added an AmbDec preset for 3D7.1 speaker setups.
70     Added documentation regarding Ambisonics, 3D7.1, AmbDec config files, and
71     the provided ambdec presets.
73     Added the ability for MMDevAPI to open devices given a Device ID or GUID
74     string.
76     Added an option to the example apps to open a specific device.
78     Increased the maximum auxiliary send limit to 16 (up from 4). Requires
79     requesting them with the ALC_MAX_AUXILIARY_SENDS context creation
80     attribute.
82     Increased the default auxiliary effect slot count to 64 (up from 4).
84     Reduced the default period count to 3 (down from 4).
86     Slightly improved automatic naming for enumerated HRTFs.
88     Improved B-Format decoding with HRTF output.
90     Improved internal property handling for better batching behavior.
92     Improved performance of certain filter uses.
94     Removed support for the AL_SOFT_buffer_samples and AL_SOFT_buffer_sub_data
95     extensions. Due to conflicts with AL_EXT_SOURCE_RADIUS.
97 openal-soft-1.17.2:
99     Implemented device enumeration for OSSv4.
101     Fixed building on OSX.
103     Fixed building on non-Windows systems without POSIX-2008.
105     Fixed Dedicated Dialog and Dedicated LFE effect output.
107     Added a build option to override the share install dir.
109     Added a build option to static-link libgcc for MinGW.
111 openal-soft-1.17.1:
113     Fixed building with JACK and without PulseAudio.
115     Fixed building on FreeBSD.
117     Fixed the ALSA backend's allow-resampler option.
119     Fixed handling of inexact ALSA period counts.
121     Altered device naming scheme on Windows backends to better match other
122     drivers.
124     Updated the CoreAudio backend to use the AudioComponent API. This clears up
125     deprecation warnings for OSX 10.11, although requires OSX 10.6 or newer.
127 openal-soft-1.17.0:
129     Implemented a JACK playback backend.
131     Implemented the AL_EXT_BFORMAT and AL_EXT_MULAW_BFORMAT extensions.
133     Implemented the ALC_SOFT_HRTF extension.
135     Implemented C, SSE3, and SSE4.1 based 4- and 8-point Sinc resamplers.
137     Implemented a C and SSE based band-limited Sinc resampler. This does 12- to
138     24-point Sinc resampling, and performs anti-aliasing.
140     Implemented B-Format output support for the wave file writer. This creates
141     FuMa-style first-order Ambisonics wave files (AMB format).
143     Implemented a stereo-mode config option for treating stereo modes as either
144     speakers or headphones.
146     Implemented per-device configuration options.
148     Fixed handling of PulseAudio and MMDevAPI devices that have identical
149     descriptions.
151     Fixed a potential lockup when stopping playback of suspended PulseAudio devices.
153     Fixed logging of Unicode characters on Windows.
155     Fixed 5.1 surround sound channels. By default it will now use the side
156     channels for the surround output. A configuration using rear channels is
157     still available.
159     Fixed the QSA backend potentially altering the capture format.
161     Fixed detecting MMDevAPI's default device.
163     Fixed returning the default capture device name.
165     Fixed mixing property calculations when deferring context updates.
167     Altered the behavior of alcSuspendContext and alcProcessContext to better
168     match certain Windows drivers.
170     Altered the panning algorithm, utilizing Ambisonics for better side and
171     back positioning cues with surround sound output.
173     Improved support for certain older Windows apps.
175     Improved the alffplay example to support surround sound streams.
177     Improved support for building as a sub-project.
179     Added an HRTF playback example.
181     Added a tone generator output test.
183     Added a toolchain to help with cross-compiling to Android.
185 openal-soft-1.16.0:
187     Implemented EFX Chorus, Flanger, Distortion, Equalizer, and Compressor
188     effects.
190     Implemented high-pass and band-pass EFX filters.
192     Implemented the high-pass filter for the EAXReverb effect.
194     Implemented SSE2 and SSE4.1 linear resamplers.
196     Implemented Neon-enhanced non-HRTF mixers.
198     Implemented a QSA backend, for QNX.
200     Implemented the ALC_SOFT_pause_device, AL_SOFT_deferred_updates,
201     AL_SOFT_block_alignment, AL_SOFT_MSADPCM, and AL_SOFT_source_length
202     extensions.
204     Fixed resetting mmdevapi backend devices.
206     Fixed clamping when converting 32-bit float samples to integer.
208     Fixed modulation range in the Modulator effect.
210     Several fixes for the OpenSL playback backend.
212     Fixed device specifier names that have Unicode characters on Windows.
214     Added support for filenames and paths with Unicode (UTF-8) characters on
215     Windows.
217     Added support for alsoft.conf config files found in XDG Base Directory
218     Specification locations (XDG_CONFIG_DIRS and XDG_CONFIG_HOME, or their
219     defaults) on non-Windows systems.
221     Added a GUI configuration utility (requires Qt 4.8).
223     Added support for environment variable expansion in config options (not
224     keys or section names).
226     Added an example that uses SDL2 and ffmpeg.
228     Modified examples to use SDL_sound.
230     Modified CMake config option names for better sorting.
232     HRTF data sets specified in the hrtf_tables config option may now be
233     relative or absolute filenames.
235     Made the default HRTF data set an external file, and added a data set for
236     48khz playback in addition to 44.1khz.
238     Added support for C11 atomic methods.
240     Improved support for some non-GNU build systems.
242 openal-soft-1.15.1:
244     Fixed a regression with retrieving the source's AL_GAIN property.
246 openal-soft-1.15:
248     Fixed device enumeration with the OSS backend.
250     Reorganized internal mixing logic, so unneeded steps can potentially be
251     skipped for better performance.
253     Removed the lookup table for calculating the mixing pans. The panning is
254     now calculated directly for better precision.
256     Improved the panning of stereo source channels when using stereo output.
258     Improved source filter quality on send paths.
260     Added a config option to allow PulseAudio to move streams between devices.
262     The PulseAudio backend will now attempt to spawn a server by default.
264     Added a workaround for a DirectSound bug relating to float32 output.
266     Added SSE-based mixers, for HRTF and non-HRTF mixing.
268     Added support for the new AL_SOFT_source_latency extension.
270     Improved ALSA capture by avoiding an extra buffer when using sizes
271     supported by the underlying device.
273     Improved the makehrtf utility to support new options and input formats.
275     Modified the CFLAGS declared in the pkg-config file so the "AL/" portion of
276     the header includes can optionally be omitted.
278     Added a couple example code programs to show how to apply reverb, and
279     retrieve latency.
281     The configuration sample is now installed into the share/openal/ directory
282     instead of /etc/openal.
284     The configuration sample now gets installed by default.