ChangeLog

   1 openal-soft-1.21.0:
   2
   3     Updated library codebase to C++14.
   4
   5     Implemented the AL_SOFT_effect_target extension.
   6
   7     Implemented the AL_SOFT_events extension.
   8
   9     Implemented the ALC_SOFT_loopback_bformat extension.
  10
  11     Improved memory use for mixing voices.
  12
  13     Improved detection of NEON capabilities.
  14
  15     Improved handling of PulseAudio devices that lack manual start control.
  16
  17     Improved mixing performance with PulseAudio.
  18
  19     Improved high-frequency scaling quality for the HRTF B-Format decoder.
  20
  21     Improved makemhr's HRIR delay calculation.
  22
  23     Improved WASAPI capture of mono formats with multichannel input.
  24
  25     Reimplemented the modulation stage for reverb.
  26
  27     Enabled real-time mixing priority by default, for backends that use the
  28     setting. It can still be disabled in the config file.
  29
  30     Enabled dual-band processing for the built-in quad and 7.1 output decoders.
  31
  32     Fixed a potential crash when deleting an effect slot immediately after the
  33     last source using it stops.
  34
  35     Fixed building with the static runtime on MSVC.
  36
  37     Fixed using source stereo angles outside of -pi...+pi.
  38
  39     Fixed the buffer processed event count for sources that start with empty
  40     buffers.
  41
  42     Fixed trying to open an unopenable WASAPI device causing all devices to
  43     stop working.
  44
  45     Fixed stale devices when re-enumerating WASAPI devices.
  46
  47     Fixed using unicode paths with the log file on Windows.
  48
  49     Fixed DirectSound capture reporting bad sample counts or erroring when
  50     reading samples.
  51
  52     Added an in-progress extension for a callback-driven buffer type.
  53
  54     Added an in-progress extension for higher-order B-Format buffers.
  55
  56     Added an in-progress extension for convolution reverb.
  57
  58     Added an experimental Oboe backend for Android playback. This requires the
  59     Oboe sources at build time, so that it's built as a static library included
  60     in libopenal.
  61
  62     Added an option for auto-connecting JACK ports.
  63
  64     Added greater-than-stereo support to the SoundIO backend.
  65
  66     Modified the mixer to be fully asynchronous with the external API, and
  67     should now be real-time safe. Although alcRenderSamplesSOFT is not due to
  68     locking to check the device handle validity.
  69
  70     Modified the UHJ encoder to use an all-pass FIR filter that's less harmful
  71     to non-filtered signal phase.
  72
  73     Converted examples from SDL_sound to libsndfile. To avoid issues when
  74     combining SDL2 and SDL_sound.
  75
  76     Worked around a 32-bit GCC/MinGW bug with TLS destructors. See:
  77     https://gcc.gnu.org/bugzilla/show_bug.cgi?id=83562
  78
  79     Reduced the maximum number of source sends from 16 to 6.
  80
  81     Removed the QSA backend. It's been broken for who knows how long.
  82
  83     Got rid of the compile-time native-tools targets, using cmake and global
  84     initialization instead. This should make cross-compiling less troublesome.
  85
  86 openal-soft-1.20.1:
  87
  88     Implemented the AL_SOFT_direct_channels_remix extension. This extends
  89     AL_DIRECT_CHANNELS_SOFT to optionally remix input channels that don't have
  90     a matching output channel.
  91
  92     Implemented the AL_SOFT_bformat_ex extension. This extends B-Format buffer
  93     support for N3D or SN3D scaling, or ACN channel ordering.
  94
  95     Fixed a potential voice leak when a source is started and stopped or
  96     restarted in quick succession.
  97
  98     Fixed a potential device reset failure with JACK.
  99
 100     Improved handling of unsupported channel configurations with WASAPI. Such
 101     setups will now try to output at least a stereo mix.
 102
 103     Improved clarity a bit for the HRTF second-order ambisonic decoder.
 104
 105     Improved detection of compatible layouts for SOFA files in makemhr and
 106     sofa-info.
 107
 108     Added the ability to resample HRTFs on load. MHR files no longer need to
 109     match the device sample rate to be usable.
 110
 111     Added an option to limit the HRTF's filter length.
 112
 113 openal-soft-1.20.0:
 114
 115     Converted the library codebase to C++11. A lot of hacks and custom
 116     structures have been replaced with standard or cleaner implementations.
 117
 118     Partially implemented the Vocal Morpher effect.
 119
 120     Fixed the bsinc SSE resamplers on non-GCC compilers.
 121
 122     Fixed OpenSL capture.
 123
 124     Fixed support for extended capture formats with OpenSL.
 125
 126     Fixed handling of WASAPI not reporting a default device.
 127
 128     Fixed performance problems relating to semaphores on macOS.
 129
 130     Modified the bsinc12 resampler's transition band to better avoid aliasing
 131     noise.
 132
 133     Modified alcResetDeviceSOFT to attempt recovery of disconnected devices.
 134
 135     Modified the virtual speaker layout for HRTF B-Format decoding.
 136
 137     Modified the PulseAudio backend to use a custom processing loop.
 138
 139     Renamed the makehrtf utility to makemhr.
 140
 141     Improved the efficiency of the bsinc resamplers when up-sampling.
 142
 143     Improved the quality of the bsinc resamplers slightly.
 144
 145     Improved the efficiency of the HRTF filters.
 146
 147     Improved the HRTF B-Format decoder coefficient generation.
 148
 149     Improved reverb feedback fading to be more consistent with pan fading.
 150
 151     Improved handling of sources that end prematurely, avoiding loud clicks.
 152
 153     Improved the performance of some reverb processing loops.
 154
 155     Added fast_bsinc12 and 24 resamplers that improve efficiency at the cost of
 156     some quality. Notably, down-sampling has less smooth pitch ramping.
 157
 158     Added support for SOFA input files with makemhr.
 159
 160     Added a build option to use pre-built native tools. For cross-compiling,
 161     use with caution and ensure the native tools' binaries are kept up-to-date.
 162
 163     Added an adjust-latency config option for the PulseAudio backend.
 164
 165     Added basic support for multi-field HRTFs.
 166
 167     Added an option for mixing first- or second-order B-Format with HRTF
 168     output. This can improve HRTF performance given a number of sources.
 169
 170     Added an RC file for proper DLL version information.
 171
 172     Disabled some old KDE workarounds by default. Specifically, PulseAudio
 173     streams can now be moved (KDE may try to move them after opening).
 174
 175 openal-soft-1.19.1:
 176
 177     Implemented capture support for the SoundIO backend.
 178
 179     Fixed source buffer queues potentially not playing properly when a queue
 180     entry completes.
 181
 182     Fixed possible unexpected failures when generating auxiliary effect slots.
 183
 184     Fixed a crash with certain reverb or device settings.
 185
 186     Fixed OpenSL capture.
 187
 188     Improved output limiter response, better ensuring the sample amplitude is
 189     clamped for output.
 190
 191 openal-soft-1.19.0:
 192
 193     Implemented the ALC_SOFT_device_clock extension.
 194
 195     Implemented the Pitch Shifter, Frequency Shifter, and Autowah effects.
 196
 197     Fixed compiling on FreeBSD systems that use freebsd-lib 9.1.
 198
 199     Fixed compiling on NetBSD.
 200
 201     Fixed the reverb effect's density scale and panning parameters.
 202
 203     Fixed use of the WASAPI backend with certain games, which caused odd COM
 204     initialization errors.
 205
 206     Increased the number of virtual channels for decoding Ambisonics to HRTF
 207     output.
 208
 209     Changed 32-bit x86 builds to use SSE2 math by default for performance.
 210     Build-time options are available to use just SSE1 or x87 instead.
 211
 212     Replaced the 4-point Sinc resampler with a more efficient cubic resampler.
 213
 214     Renamed the MMDevAPI backend to WASAPI.
 215
 216     Added support for 24-bit, dual-ear HRTF data sets. The built-in data set
 217     has been updated to 24-bit.
 218
 219     Added a 24- to 48-point band-limited Sinc resampler.
 220
 221     Added an SDL2 playback backend. Disabled by default to avoid a dependency
 222     on SDL2.
 223
 224     Improved the performance and quality of the Chorus and Flanger effects.
 225
 226     Improved the efficiency of the band-limited Sinc resampler.
 227
 228     Improved the Sinc resampler's transition band to avoid over-attenuating
 229     higher frequencies.
 230
 231     Improved the performance of some filter operations.
 232
 233     Improved the efficiency of object ID lookups.
 234
 235     Improved the efficienty of internal voice/source synchronization.
 236
 237     Improved AL call error logging with contextualized messages.
 238
 239     Removed the reverb effect's modulation stage. Due to the lack of reference
 240     for its intended behavior and strength.
 241
 242 openal-soft-1.18.2:
 243
 244     Fixed resetting the FPU rounding mode after certain function calls on
 245     Windows.
 246
 247     Fixed use of SSE intrinsics when building with Clang on Windows.
 248
 249     Fixed a crash with the JACK backend when using JACK1.
 250
 251     Fixed use of pthread_setnane_np on NetBSD.
 252
 253     Fixed building on FreeBSD with an older freebsd-lib.
 254
 255     OSS now links with libossaudio if found at build time (for NetBSD).
 256
 257 openal-soft-1.18.1:
 258
 259     Fixed an issue where resuming a source might not restart playing it.
 260
 261     Fixed PulseAudio playback when the configured stream length is much less
 262     than the requested length.
 263
 264     Fixed MMDevAPI capture with sample rates not matching the backing device.
 265
 266     Fixed int32 output for the Wave Writer.
 267
 268     Fixed enumeration of OSS devices that are missing device files.
 269
 270     Added correct retrieval of the executable's path on FreeBSD.
 271
 272     Added a config option to specify the dithering depth.
 273
 274     Added a 5.1 decoder preset that excludes front-center output.
 275
 276 openal-soft-1.18.0:
 277
 278     Implemented the AL_EXT_STEREO_ANGLES and AL_EXT_SOURCE_RADIUS extensions.
 279
 280     Implemented the AL_SOFT_gain_clamp_ex, AL_SOFT_source_resampler,
 281     AL_SOFT_source_spatialize, and ALC_SOFT_output_limiter extensions.
 282
 283     Implemented 3D processing for some effects. Currently implemented for
 284     Reverb, Compressor, Equalizer, and Ring Modulator.
 285
 286     Implemented 2-channel UHJ output encoding. This needs to be enabled with a
 287     config option to be used.
 288
 289     Implemented dual-band processing for high-quality ambisonic decoding.
 290
 291     Implemented distance-compensation for surround sound output.
 292
 293     Implemented near-field emulation and compensation with ambisonic rendering.
 294     Currently only applies when using the high-quality ambisonic decoder or
 295     ambisonic output, with appropriate config options.
 296
 297     Implemented an output limiter to reduce the amount of distortion from
 298     clipping.
 299
 300     Implemented dithering for 8-bit and 16-bit output.
 301
 302     Implemented a config option to select a preferred HRTF.
 303
 304     Implemented a run-time check for NEON extensions using /proc/cpuinfo.
 305
 306     Implemented experimental capture support for the OpenSL backend.
 307
 308     Fixed building on compilers with NEON support but don't default to having
 309     NEON enabled.
 310
 311     Fixed support for JACK on Windows.
 312
 313     Fixed starting a source while alcSuspendContext is in effect.
 314
 315     Fixed detection of headsets as headphones, with MMDevAPI.
 316
 317     Added support for AmbDec config files, for custom ambisonic decoder
 318     configurations. Version 3 files only.
 319
 320     Added backend-specific options to alsoft-config.
 321
 322     Added first-, second-, and third-order ambisonic output formats. Currently
 323     only works with backends that don't rely on channel labels, like JACK,
 324     ALSA, and OSS.
 325
 326     Added a build option to embed the default HRTFs into the lib.
 327
 328     Added AmbDec presets to enable high-quality ambisonic decoding.
 329
 330     Added an AmbDec preset for 3D7.1 speaker setups.
 331
 332     Added documentation regarding Ambisonics, 3D7.1, AmbDec config files, and
 333     the provided ambdec presets.
 334
 335     Added the ability for MMDevAPI to open devices given a Device ID or GUID
 336     string.
 337
 338     Added an option to the example apps to open a specific device.
 339
 340     Increased the maximum auxiliary send limit to 16 (up from 4). Requires
 341     requesting them with the ALC_MAX_AUXILIARY_SENDS context creation
 342     attribute.
 343
 344     Increased the default auxiliary effect slot count to 64 (up from 4).
 345
 346     Reduced the default period count to 3 (down from 4).
 347
 348     Slightly improved automatic naming for enumerated HRTFs.
 349
 350     Improved B-Format decoding with HRTF output.
 351
 352     Improved internal property handling for better batching behavior.
 353
 354     Improved performance of certain filter uses.
 355
 356     Removed support for the AL_SOFT_buffer_samples and AL_SOFT_buffer_sub_data
 357     extensions. Due to conflicts with AL_EXT_SOURCE_RADIUS.
 358
 359 openal-soft-1.17.2:
 360
 361     Implemented device enumeration for OSSv4.
 362
 363     Fixed building on OSX.
 364
 365     Fixed building on non-Windows systems without POSIX-2008.
 366
 367     Fixed Dedicated Dialog and Dedicated LFE effect output.
 368
 369     Added a build option to override the share install dir.
 370
 371     Added a build option to static-link libgcc for MinGW.
 372
 373 openal-soft-1.17.1:
 374
 375     Fixed building with JACK and without PulseAudio.
 376
 377     Fixed building on FreeBSD.
 378
 379     Fixed the ALSA backend's allow-resampler option.
 380
 381     Fixed handling of inexact ALSA period counts.
 382
 383     Altered device naming scheme on Windows backends to better match other
 384     drivers.
 385
 386     Updated the CoreAudio backend to use the AudioComponent API. This clears up
 387     deprecation warnings for OSX 10.11, although requires OSX 10.6 or newer.
 388
 389 openal-soft-1.17.0:
 390
 391     Implemented a JACK playback backend.
 392
 393     Implemented the AL_EXT_BFORMAT and AL_EXT_MULAW_BFORMAT extensions.
 394
 395     Implemented the ALC_SOFT_HRTF extension.
 396
 397     Implemented C, SSE3, and SSE4.1 based 4- and 8-point Sinc resamplers.
 398
 399     Implemented a C and SSE based band-limited Sinc resampler. This does 12- to
 400     24-point Sinc resampling, and performs anti-aliasing.
 401
 402     Implemented B-Format output support for the wave file writer. This creates
 403     FuMa-style first-order Ambisonics wave files (AMB format).
 404
 405     Implemented a stereo-mode config option for treating stereo modes as either
 406     speakers or headphones.
 407
 408     Implemented per-device configuration options.
 409
 410     Fixed handling of PulseAudio and MMDevAPI devices that have identical
 411     descriptions.
 412
 413     Fixed a potential lockup when stopping playback of suspended PulseAudio devices.
 414
 415     Fixed logging of Unicode characters on Windows.
 416
 417     Fixed 5.1 surround sound channels. By default it will now use the side
 418     channels for the surround output. A configuration using rear channels is
 419     still available.
 420
 421     Fixed the QSA backend potentially altering the capture format.
 422
 423     Fixed detecting MMDevAPI's default device.
 424
 425     Fixed returning the default capture device name.
 426
 427     Fixed mixing property calculations when deferring context updates.
 428
 429     Altered the behavior of alcSuspendContext and alcProcessContext to better
 430     match certain Windows drivers.
 431
 432     Altered the panning algorithm, utilizing Ambisonics for better side and
 433     back positioning cues with surround sound output.
 434
 435     Improved support for certain older Windows apps.
 436
 437     Improved the alffplay example to support surround sound streams.
 438
 439     Improved support for building as a sub-project.
 440
 441     Added an HRTF playback example.
 442
 443     Added a tone generator output test.
 444
 445     Added a toolchain to help with cross-compiling to Android.
 446
 447 openal-soft-1.16.0:
 448
 449     Implemented EFX Chorus, Flanger, Distortion, Equalizer, and Compressor
 450     effects.
 451
 452     Implemented high-pass and band-pass EFX filters.
 453
 454     Implemented the high-pass filter for the EAXReverb effect.
 455
 456     Implemented SSE2 and SSE4.1 linear resamplers.
 457
 458     Implemented Neon-enhanced non-HRTF mixers.
 459
 460     Implemented a QSA backend, for QNX.
 461
 462     Implemented the ALC_SOFT_pause_device, AL_SOFT_deferred_updates,
 463     AL_SOFT_block_alignment, AL_SOFT_MSADPCM, and AL_SOFT_source_length
 464     extensions.
 465
 466     Fixed resetting mmdevapi backend devices.
 467
 468     Fixed clamping when converting 32-bit float samples to integer.
 469
 470     Fixed modulation range in the Modulator effect.
 471
 472     Several fixes for the OpenSL playback backend.
 473
 474     Fixed device specifier names that have Unicode characters on Windows.
 475
 476     Added support for filenames and paths with Unicode (UTF-8) characters on
 477     Windows.
 478
 479     Added support for alsoft.conf config files found in XDG Base Directory
 480     Specification locations (XDG_CONFIG_DIRS and XDG_CONFIG_HOME, or their
 481     defaults) on non-Windows systems.
 482
 483     Added a GUI configuration utility (requires Qt 4.8).
 484
 485     Added support for environment variable expansion in config options (not
 486     keys or section names).
 487
 488     Added an example that uses SDL2 and ffmpeg.
 489
 490     Modified examples to use SDL_sound.
 491
 492     Modified CMake config option names for better sorting.
 493
 494     HRTF data sets specified in the hrtf_tables config option may now be
 495     relative or absolute filenames.
 496
 497     Made the default HRTF data set an external file, and added a data set for
 498     48khz playback in addition to 44.1khz.
 499
 500     Added support for C11 atomic methods.
 501
 502     Improved support for some non-GNU build systems.
 503
 504 openal-soft-1.15.1:
 505
 506     Fixed a regression with retrieving the source's AL_GAIN property.
 507
 508 openal-soft-1.15:
 509
 510     Fixed device enumeration with the OSS backend.
 511
 512     Reorganized internal mixing logic, so unneeded steps can potentially be
 513     skipped for better performance.
 514
 515     Removed the lookup table for calculating the mixing pans. The panning is
 516     now calculated directly for better precision.
 517
 518     Improved the panning of stereo source channels when using stereo output.
 519
 520     Improved source filter quality on send paths.
 521
 522     Added a config option to allow PulseAudio to move streams between devices.
 523
 524     The PulseAudio backend will now attempt to spawn a server by default.
 525
 526     Added a workaround for a DirectSound bug relating to float32 output.
 527
 528     Added SSE-based mixers, for HRTF and non-HRTF mixing.
 529
 530     Added support for the new AL_SOFT_source_latency extension.
 531
 532     Improved ALSA capture by avoiding an extra buffer when using sizes
 533     supported by the underlying device.
 534
 535     Improved the makehrtf utility to support new options and input formats.
 536
 537     Modified the CFLAGS declared in the pkg-config file so the "AL/" portion of
 538     the header includes can optionally be omitted.
 539
 540     Added a couple example code programs to show how to apply reverb, and
 541     retrieve latency.
 542
 543     The configuration sample is now installed into the share/openal/ directory
 544     instead of /etc/openal.
 545
 546     The configuration sample now gets installed by default.