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