Some suggested changes for iOS
[openal-soft.git] / ChangeLog
blob6134e11338c256c16cee9c5c0e9b4897c9b4a8c9
1 openal-soft-1.19.0:
3     Implemented the ALC_SOFT_device_clock extension.
5     Implemented the Pitch Shifter, Frequency Shifter, and Autowah effects.
7     Fixed compiling on FreeBSD systems that use freebsd-lib 9.1.
9     Fixed compiling on NetBSD.
11     Fixed the reverb effect's density scale and panning parameters.
13     Fixed use of the WASAPI backend with certain games, which caused odd COM
14     initialization errors.
16     Increased the number of virtual channels for decoding Ambisonics to HRTF
17     output.
19     Changed 32-bit x86 builds to use SSE2 math by default for performance.
20     Build-time options are available to use just SSE1 or x87 instead.
22     Replaced the 4-point Sinc resampler with a more efficient cubic resampler.
24     Renamed the MMDevAPI backend to WASAPI.
26     Added support for 24-bit, dual-ear HRTF data sets. The built-in data set
27     has been updated to 24-bit.
29     Added a 24- to 48-point band-limited Sinc resampler.
31     Added an SDL2 playback backend. Disabled by default to avoid a dependency
32     on SDL2.
34     Improved the performance and quality of the Chorus and Flanger effects.
36     Improved the efficiency of the band-limited Sinc resampler.
38     Improved the Sinc resampler's transition band to avoid over-attenuating
39     higher frequencies.
41     Improved the performance of some filter operations.
43     Improved the efficiency of object ID lookups.
45     Improved the efficienty of internal voice/source synchronization.
47     Improved AL call error logging with contextualized messages.
49     Removed the reverb effect's modulation stage. Due to the lack of reference
50     for its intended behavior and strength.
52 openal-soft-1.18.2:
54     Fixed resetting the FPU rounding mode after certain function calls on
55     Windows.
57     Fixed use of SSE intrinsics when building with Clang on Windows.
59     Fixed a crash with the JACK backend when using JACK1.
61     Fixed use of pthread_setnane_np on NetBSD.
63     Fixed building on FreeBSD with an older freebsd-lib.
65     OSS now links with libossaudio if found at build time (for NetBSD).
67 openal-soft-1.18.1:
69     Fixed an issue where resuming a source might not restart playing it.
71     Fixed PulseAudio playback when the configured stream length is much less
72     than the requested length.
74     Fixed MMDevAPI capture with sample rates not matching the backing device.
76     Fixed int32 output for the Wave Writer.
78     Fixed enumeration of OSS devices that are missing device files.
80     Added correct retrieval of the executable's path on FreeBSD.
82     Added a config option to specify the dithering depth.
84     Added a 5.1 decoder preset that excludes front-center output.
86 openal-soft-1.18.0:
88     Implemented the AL_EXT_STEREO_ANGLES and AL_EXT_SOURCE_RADIUS extensions.
90     Implemented the AL_SOFT_gain_clamp_ex, AL_SOFT_source_resampler,
91     AL_SOFT_source_spatialize, and ALC_SOFT_output_limiter extensions.
93     Implemented 3D processing for some effects. Currently implemented for
94     Reverb, Compressor, Equalizer, and Ring Modulator.
96     Implemented 2-channel UHJ output encoding. This needs to be enabled with a
97     config option to be used.
99     Implemented dual-band processing for high-quality ambisonic decoding.
101     Implemented distance-compensation for surround sound output.
103     Implemented near-field emulation and compensation with ambisonic rendering.
104     Currently only applies when using the high-quality ambisonic decoder or
105     ambisonic output, with appropriate config options.
107     Implemented an output limiter to reduce the amount of distortion from
108     clipping.
110     Implemented dithering for 8-bit and 16-bit output.
112     Implemented a config option to select a preferred HRTF.
114     Implemented a run-time check for NEON extensions using /proc/cpuinfo.
116     Implemented experimental capture support for the OpenSL backend.
118     Fixed building on compilers with NEON support but don't default to having
119     NEON enabled.
121     Fixed support for JACK on Windows.
123     Fixed starting a source while alcSuspendContext is in effect.
125     Fixed detection of headsets as headphones, with MMDevAPI.
127     Added support for AmbDec config files, for custom ambisonic decoder
128     configurations. Version 3 files only.
130     Added backend-specific options to alsoft-config.
132     Added first-, second-, and third-order ambisonic output formats. Currently
133     only works with backends that don't rely on channel labels, like JACK,
134     ALSA, and OSS.
136     Added a build option to embed the default HRTFs into the lib.
138     Added AmbDec presets to enable high-quality ambisonic decoding.
140     Added an AmbDec preset for 3D7.1 speaker setups.
142     Added documentation regarding Ambisonics, 3D7.1, AmbDec config files, and
143     the provided ambdec presets.
145     Added the ability for MMDevAPI to open devices given a Device ID or GUID
146     string.
148     Added an option to the example apps to open a specific device.
150     Increased the maximum auxiliary send limit to 16 (up from 4). Requires
151     requesting them with the ALC_MAX_AUXILIARY_SENDS context creation
152     attribute.
154     Increased the default auxiliary effect slot count to 64 (up from 4).
156     Reduced the default period count to 3 (down from 4).
158     Slightly improved automatic naming for enumerated HRTFs.
160     Improved B-Format decoding with HRTF output.
162     Improved internal property handling for better batching behavior.
164     Improved performance of certain filter uses.
166     Removed support for the AL_SOFT_buffer_samples and AL_SOFT_buffer_sub_data
167     extensions. Due to conflicts with AL_EXT_SOURCE_RADIUS.
169 openal-soft-1.17.2:
171     Implemented device enumeration for OSSv4.
173     Fixed building on OSX.
175     Fixed building on non-Windows systems without POSIX-2008.
177     Fixed Dedicated Dialog and Dedicated LFE effect output.
179     Added a build option to override the share install dir.
181     Added a build option to static-link libgcc for MinGW.
183 openal-soft-1.17.1:
185     Fixed building with JACK and without PulseAudio.
187     Fixed building on FreeBSD.
189     Fixed the ALSA backend's allow-resampler option.
191     Fixed handling of inexact ALSA period counts.
193     Altered device naming scheme on Windows backends to better match other
194     drivers.
196     Updated the CoreAudio backend to use the AudioComponent API. This clears up
197     deprecation warnings for OSX 10.11, although requires OSX 10.6 or newer.
199 openal-soft-1.17.0:
201     Implemented a JACK playback backend.
203     Implemented the AL_EXT_BFORMAT and AL_EXT_MULAW_BFORMAT extensions.
205     Implemented the ALC_SOFT_HRTF extension.
207     Implemented C, SSE3, and SSE4.1 based 4- and 8-point Sinc resamplers.
209     Implemented a C and SSE based band-limited Sinc resampler. This does 12- to
210     24-point Sinc resampling, and performs anti-aliasing.
212     Implemented B-Format output support for the wave file writer. This creates
213     FuMa-style first-order Ambisonics wave files (AMB format).
215     Implemented a stereo-mode config option for treating stereo modes as either
216     speakers or headphones.
218     Implemented per-device configuration options.
220     Fixed handling of PulseAudio and MMDevAPI devices that have identical
221     descriptions.
223     Fixed a potential lockup when stopping playback of suspended PulseAudio devices.
225     Fixed logging of Unicode characters on Windows.
227     Fixed 5.1 surround sound channels. By default it will now use the side
228     channels for the surround output. A configuration using rear channels is
229     still available.
231     Fixed the QSA backend potentially altering the capture format.
233     Fixed detecting MMDevAPI's default device.
235     Fixed returning the default capture device name.
237     Fixed mixing property calculations when deferring context updates.
239     Altered the behavior of alcSuspendContext and alcProcessContext to better
240     match certain Windows drivers.
242     Altered the panning algorithm, utilizing Ambisonics for better side and
243     back positioning cues with surround sound output.
245     Improved support for certain older Windows apps.
247     Improved the alffplay example to support surround sound streams.
249     Improved support for building as a sub-project.
251     Added an HRTF playback example.
253     Added a tone generator output test.
255     Added a toolchain to help with cross-compiling to Android.
257 openal-soft-1.16.0:
259     Implemented EFX Chorus, Flanger, Distortion, Equalizer, and Compressor
260     effects.
262     Implemented high-pass and band-pass EFX filters.
264     Implemented the high-pass filter for the EAXReverb effect.
266     Implemented SSE2 and SSE4.1 linear resamplers.
268     Implemented Neon-enhanced non-HRTF mixers.
270     Implemented a QSA backend, for QNX.
272     Implemented the ALC_SOFT_pause_device, AL_SOFT_deferred_updates,
273     AL_SOFT_block_alignment, AL_SOFT_MSADPCM, and AL_SOFT_source_length
274     extensions.
276     Fixed resetting mmdevapi backend devices.
278     Fixed clamping when converting 32-bit float samples to integer.
280     Fixed modulation range in the Modulator effect.
282     Several fixes for the OpenSL playback backend.
284     Fixed device specifier names that have Unicode characters on Windows.
286     Added support for filenames and paths with Unicode (UTF-8) characters on
287     Windows.
289     Added support for alsoft.conf config files found in XDG Base Directory
290     Specification locations (XDG_CONFIG_DIRS and XDG_CONFIG_HOME, or their
291     defaults) on non-Windows systems.
293     Added a GUI configuration utility (requires Qt 4.8).
295     Added support for environment variable expansion in config options (not
296     keys or section names).
298     Added an example that uses SDL2 and ffmpeg.
300     Modified examples to use SDL_sound.
302     Modified CMake config option names for better sorting.
304     HRTF data sets specified in the hrtf_tables config option may now be
305     relative or absolute filenames.
307     Made the default HRTF data set an external file, and added a data set for
308     48khz playback in addition to 44.1khz.
310     Added support for C11 atomic methods.
312     Improved support for some non-GNU build systems.
314 openal-soft-1.15.1:
316     Fixed a regression with retrieving the source's AL_GAIN property.
318 openal-soft-1.15:
320     Fixed device enumeration with the OSS backend.
322     Reorganized internal mixing logic, so unneeded steps can potentially be
323     skipped for better performance.
325     Removed the lookup table for calculating the mixing pans. The panning is
326     now calculated directly for better precision.
328     Improved the panning of stereo source channels when using stereo output.
330     Improved source filter quality on send paths.
332     Added a config option to allow PulseAudio to move streams between devices.
334     The PulseAudio backend will now attempt to spawn a server by default.
336     Added a workaround for a DirectSound bug relating to float32 output.
338     Added SSE-based mixers, for HRTF and non-HRTF mixing.
340     Added support for the new AL_SOFT_source_latency extension.
342     Improved ALSA capture by avoiding an extra buffer when using sizes
343     supported by the underlying device.
345     Improved the makehrtf utility to support new options and input formats.
347     Modified the CFLAGS declared in the pkg-config file so the "AL/" portion of
348     the header includes can optionally be omitted.
350     Added a couple example code programs to show how to apply reverb, and
351     retrieve latency.
353     The configuration sample is now installed into the share/openal/ directory
354     instead of /etc/openal.
356     The configuration sample now gets installed by default.