Skip to content

Changelog.md

Latest commit

 

History

History
115 lines (100 loc) · 5.75 KB

Changelog.md

File metadata and controls

115 lines (100 loc) · 5.75 KB
Raw

Changes in 0.4.1

This is a minor release fixing some build issues and API correctness:

  • Properly handle mysofa initialization failures by throwing an exception.
  • Handle exceptions when initializing HRTF objects, so Configure on objects that use HRTF internally will correctly return false instead of throwing.
  • Fix PkgConfig file generated on Windows when using MSVC.
  • Fix build with older GCC versions by changing deprecation annotations
  • Define _USE_MATH_DEFINES globally, if needed. Note that this will change in a future version, so do not rely on this behavior.
  • Add an option (BUILD_TESTING) and default to not build any tests.
  • Add libspatialaudio version defines to SpatialaudioConfig.h, these contain the library version. For the API version use the defines in SpatialaudioVersion.h.

Changes in 0.4.0

This release is a huge evolution for libspatialaudio from its origin as a Higher Order Ambisonics library.

This new release expands functionality to include object-based audio, additional loudspeaker layout support, binauralizations and many more new features that makes this library ready for rendering all type of spatial audio.

This is all unified in a Renderer class for Ambisonics, object-based audio, speaker layouts and binauralization. This makes it a much more comprehensive and easier to use library for immersive audio. The Renderer is designed to adapt easily to ADM and IAMF next‑generation audio workflows.

Main Updates:

Object-Based Audio: Position and render individual sources dynamically in 3D space, compatible with ITU ADM and AOM’s IAMF immersive audio standards.

Unified Renderer Class: Seamlessly process HOA, object signals, speaker feeds, and binaural output under one API.

Cross-Platform Builds: Modernized build system with Meson and CMake, ensuring reproducibility across different operating systems.

Robust Documentation: Expanded theory, DSP background, and code examples for both newcomers and advanced developers.

Real-time Improvements: The code is now more efficient and real-time safe, making it suitable for AR/AR and gaming applications.

Higher Order Ambisonics (HOA): Efficiency and real-time improvements, as well as now supporting decoding to ITU standard loudspeaker layouts (5.1, 7.1.4, etc.)

API changes

  • This is an API and ABI breaking release.
  • Move Classes to the spaudio namespace.
  • Simplified class names:
    • CAdmDirectSpeakersGainCalc to AdmDirectSpeakersGainCalc
    • CAdmRenderer to Renderer
    • CAllocentricExtent to AllocentricExtent
    • CAllocentricPannerGainCalc to AllocentricPannerGainCalc
    • CAmbisonicAllRAD to AmbisonicAllRAD
    • CAmbisonicBase to AmbisonicBase
    • CAmbisonicBinauralizer to AmbisonicBinauralizer
    • CAmbisonicDecoder to AmbisonicDecoder
    • CAmbisonicEncoder to AmbisonicEncoder
    • CAmbisonicEncoderDist to AmbisonicEncoderDist
    • CAmbisonicMicrophone to AmbisonicMicrophone
    • CAmbisonicOptimFilters to AmbisonicOptimFilters
    • CAmbisonicPolarExtentHandler to AmbisonicPolarExtentHandler
    • CAmbisonicProcessor to AmbisonicProcessor
    • CAmbisonicRotator to AmbisonicRotator
    • CAmbisonicShelfFilters to AmbisonicShelfFilters
    • CAmbisonicSource to AmbisonicSource
    • CAmbisonicSpeaker to AmbisonicSpeaker
    • CAmbisonicSpreadPanner to AmbisonicSpreadPanner
    • CAmbisonicZoomer to AmbisonicZoomer
    • CBFormat to BFormat
    • CDecorrelator to Decorrelator
    • CGainCalculator to GainCalculator
    • CGainInterp to GainInterp
    • CIIRFilter to IIRFilter
    • CLinkwitzRileyIIR to LinkwitzRileyIIR
    • CPointSourcePannerGainCalc to PointSourcePannerGainCalc
    • CPolarExtentHandler to PolarExtentHandler
    • CPolarExtentHandlerBase to PolarExtentHandlerBase
    • CScreenEdgeLock to ScreenEdgeLockHandler
    • CScreenScaleHandler to ScreenScaleHandler
    • CSpreadPanner to SpreadPanner
    • CSpreadPannerBase to SpreadPannerBase
  • Changed LFE handling for the Renderer (formerly AdmRenderer) when rendering to binaural. Before, LFE channels would be discarded when rendering to binaural, following the ADM specification. Now they are included and a new argument useLfeBinaural was added to Configure, to change this behaviour if necessary.
  • OutputLayout moved to the LoutspeakerLayout.h header.
  • Removed/replaced some OutputLayout entries:
    • Replaced OutputLayout::ITU_0_2_0, use OutputLayout::Stereo
    • Replaced OutputLayout::ITU_0_5_0, use OutputLayout::FivePointOne
    • Replaced OutputLayout::ITU_2_5_0, use OutputLayout::FivePointOnePointTwo
    • Replaced OutputLayout::ITU_4_5_0, use OutputLayout::FivePointOnePointFour
    • Replaced OutputLayout::ITU_4_5_1, use OutputLayout::FivePointOnePointFourPlusLow
    • Replaced OutputLayout::ITU_3_7_0, use OutputLayout::SevenPointOnePointThree
    • Replaced OutputLayout::ITU_3_7_0, use OutputLayout::SevenPointOnePointThree
    • Replaced OutputLayout::ITU_4_9_0, use OutputLayout::ThirteenPointOne
    • Replaced OutputLayout::ITU_9_10_3, use OutputLayout::TwentyTwoPointTwo
    • Replaced OutputLayout::ITU_0_7_0, use OutputLayout::SevenPointOne
    • Replaced OutputLayout::ITU_4_7_0, use OutputLayout::SevenPointOnePointFour
    • Replaced OutputLayout::_3p1p2, use OutputLayout::ThreePointOnePointTwo
    • Replaced OutputLayout::_2_7_0, use OutputLayout::SevenPointOnePointTwo
    • Removed OutputLayout::FivePointZero
    • Removed OutputLayout::SevenPointZero
  • CMake: Removed the BUILD_STATIC_LIBS option. Use the BUILD_SHARED_LIBS option to control if share or static libraries should be built. If both are needed, build twice explicitly.
  • The config.h header file was removed in favor of SpatialaudioConfig.h with properly prefixed defines to prevent name clashes.