ChangeLog

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