Add a property to force source spatialization on or off
[openal-soft.git] / ChangeLog
blobf3bb5f5c6827b8515e433e7deafa9ea0e6fac4b0
1 openal-soft-1.18.0:
3     Implemented the AL_EXT_STEREO_ANGLES, AL_EXT_SOURCE_RADIUS,
4     AL_SOFT_gain_clamp_ex, and AL_SOFT_source_resampler extensions.
6     Implemented 3D processing for some effects. Currently implemented for
7     Reverb, Compressor, Equalizer, and Ring Modulator.
9     Implemented 2-channel UHJ output encoding. This needs to be enabled with a
10     config option to be used.
12     Implemented dual-band processing for high-quality ambisonic decoding.
14     Implemented distance-compensation for surround sound output.
16     Implemented near-field emulation and compensation with ambisonic rendering.
17     Currently only applies when using the high-quality ambisonic decoder or
18     ambisonic output, with appropriate config options.
20     Implemented a config option to select a preferred HRTF.
22     Implemented a run-time check for NEON extensions using /proc/cpuinfo.
24     Fixed building on compilers with NEON support but don't default to having
25     NEON enabled.
27     Fixed support for JACK on Windows.
29     Fixed starting a source while alcSuspendContext is in effect.
31     Fixed detection of headsets as headphones, with MMDevAPI.
33     Added support for AmbDec config files, for custom ambisonic decoder
34     configurations. Version 3 files only.
36     Added backend-specific options to alsoft-config.
38     Added first-, second-, and third-order ambisonic output formats. Currently
39     only works with backends that don't rely on channel labels, like JACK,
40     ALSA, and OSS.
42     Added a build option to embed the default HRTFs into the lib.
44     Added AmbDec presets to enable high-quality ambisonic decoding.
46     Added an AmbDec preset for 3D7.1 speaker setups.
48     Added documentation regarding Ambisonics, 3D7.1, AmbDec config files, and
49     the provided ambdec presets.
51     Added the ability for MMDevAPI to open devices given a Device ID or GUID
52     string.
54     Added an option to the example apps to open a specific device.
56     Increased the maximum auxiliary send limit to 16 (up from 4). Requires
57     requesting them with the ALC_MAX_AUXILIARY_SENDS context creation
58     attribute.
60     Increased the default auxiliary effect slot count to 64 (up from 4).
62     Reduced the default period count to 3 (down from 4).
64     Slightly improved automatic naming for enumerated HRTFs.
66     Improved B-Format decoding with HRTF output.
68     Improved internal property handling for better batching behavior.
70     Improved performance of certain filter uses.
72     Altered cone behavior for automatic auxiliary send gain and gainhf
73     management. Now better represents the energy the room receives.
75     Removed support for the AL_SOFT_buffer_samples and AL_SOFT_buffer_sub_data
76     extensions. Due to conflicts with AL_EXT_SOURCE_RADIUS.
78 openal-soft-1.17.2:
80     Implemented device enumeration for OSSv4.
82     Fixed building on OSX.
84     Fixed building on non-Windows systems without POSIX-2008.
86     Fixed Dedicated Dialog and Dedicated LFE effect output.
88     Added a build option to override the share install dir.
90     Added a build option to static-link libgcc for MinGW.
92 openal-soft-1.17.1:
94     Fixed building with JACK and without PulseAudio.
96     Fixed building on FreeBSD.
98     Fixed the ALSA backend's allow-resampler option.
100     Fixed handling of inexact ALSA period counts.
102     Altered device naming scheme on Windows backends to better match other
103     drivers.
105     Updated the CoreAudio backend to use the AudioComponent API. This clears up
106     deprecation warnings for OSX 10.11, although requires OSX 10.6 or newer.
108 openal-soft-1.17.0:
110     Implemented a JACK playback backend.
112     Implemented the AL_EXT_BFORMAT and AL_EXT_MULAW_BFORMAT extensions.
114     Implemented the ALC_SOFT_HRTF extension.
116     Implemented C, SSE3, and SSE4.1 based 4- and 8-point Sinc resamplers.
118     Implemented a C and SSE based band-limited Sinc resampler. This does 12- to
119     24-point Sinc resampling, and performs anti-aliasing.
121     Implemented B-Format output support for the wave file writer. This creates
122     FuMa-style first-order Ambisonics wave files (AMB format).
124     Implemented a stereo-mode config option for treating stereo modes as either
125     speakers or headphones.
127     Implemented per-device configuration options.
129     Fixed handling of PulseAudio and MMDevAPI devices that have identical
130     descriptions.
132     Fixed a potential lockup when stopping playback of suspended PulseAudio devices.
134     Fixed logging of Unicode characters on Windows.
136     Fixed 5.1 surround sound channels. By default it will now use the side
137     channels for the surround output. A configuration using rear channels is
138     still available.
140     Fixed the QSA backend potentially altering the capture format.
142     Fixed detecting MMDevAPI's default device.
144     Fixed returning the default capture device name.
146     Fixed mixing property calculations when deferring context updates.
148     Altered the behavior of alcSuspendContext and alcProcessContext to better
149     match certain Windows drivers.
151     Altered the panning algorithm, utilizing Ambisonics for better side and
152     back positioning cues with surround sound output.
154     Improved support for certain older Windows apps.
156     Improved the alffplay example to support surround sound streams.
158     Improved support for building as a sub-project.
160     Added an HRTF playback example.
162     Added a tone generator output test.
164     Added a toolchain to help with cross-compiling to Android.
166 openal-soft-1.16.0:
168     Implemented EFX Chorus, Flanger, Distortion, Equalizer, and Compressor
169     effects.
171     Implemented high-pass and band-pass EFX filters.
173     Implemented the high-pass filter for the EAXReverb effect.
175     Implemented SSE2 and SSE4.1 linear resamplers.
177     Implemented Neon-enhanced non-HRTF mixers.
179     Implemented a QSA backend, for QNX.
181     Implemented the ALC_SOFT_pause_device, AL_SOFT_deferred_updates,
182     AL_SOFT_block_alignment, AL_SOFT_MSADPCM, and AL_SOFT_source_length
183     extensions.
185     Fixed resetting mmdevapi backend devices.
187     Fixed clamping when converting 32-bit float samples to integer.
189     Fixed modulation range in the Modulator effect.
191     Several fixes for the OpenSL playback backend.
193     Fixed device specifier names that have Unicode characters on Windows.
195     Added support for filenames and paths with Unicode (UTF-8) characters on
196     Windows.
198     Added support for alsoft.conf config files found in XDG Base Directory
199     Specification locations (XDG_CONFIG_DIRS and XDG_CONFIG_HOME, or their
200     defaults) on non-Windows systems.
202     Added a GUI configuration utility (requires Qt 4.8).
204     Added support for environment variable expansion in config options (not
205     keys or section names).
207     Added an example that uses SDL2 and ffmpeg.
209     Modified examples to use SDL_sound.
211     Modified CMake config option names for better sorting.
213     HRTF data sets specified in the hrtf_tables config option may now be
214     relative or absolute filenames.
216     Made the default HRTF data set an external file, and added a data set for
217     48khz playback in addition to 44.1khz.
219     Added support for C11 atomic methods.
221     Improved support for some non-GNU build systems.
223 openal-soft-1.15.1:
225     Fixed a regression with retrieving the source's AL_GAIN property.
227 openal-soft-1.15:
229     Fixed device enumeration with the OSS backend.
231     Reorganized internal mixing logic, so unneeded steps can potentially be
232     skipped for better performance.
234     Removed the lookup table for calculating the mixing pans. The panning is
235     now calculated directly for better precision.
237     Improved the panning of stereo source channels when using stereo output.
239     Improved source filter quality on send paths.
241     Added a config option to allow PulseAudio to move streams between devices.
243     The PulseAudio backend will now attempt to spawn a server by default.
245     Added a workaround for a DirectSound bug relating to float32 output.
247     Added SSE-based mixers, for HRTF and non-HRTF mixing.
249     Added support for the new AL_SOFT_source_latency extension.
251     Improved ALSA capture by avoiding an extra buffer when using sizes
252     supported by the underlying device.
254     Improved the makehrtf utility to support new options and input formats.
256     Modified the CFLAGS declared in the pkg-config file so the "AL/" portion of
257     the header includes can optionally be omitted.
259     Added a couple example code programs to show how to apply reverb, and
260     retrieve latency.
262     The configuration sample is now installed into the share/openal/ directory
263     instead of /etc/openal.
265     The configuration sample now gets installed by default.