axmol/thirdparty/openal
halx99 77dbc3a70e Add openal missing file 2023-05-03 19:17:51 +08:00
..
al Update openal-soft to 1.23.1 2023-05-03 18:59:33 +08:00
alc Update openal-soft to 1.23.1 2023-05-03 18:59:33 +08:00
cmake Update thirdparty libs 2023-02-04 15:03:54 +08:00
common Update openal-soft to 1.23.1 2023-05-03 18:59:33 +08:00
core Update openal-soft to 1.23.1 2023-05-03 18:59:33 +08:00
examples/common Update thirdparty libs 2023-02-04 15:03:54 +08:00
hrtf Update thirdparty libs 2023-02-04 15:03:54 +08:00
include/AL Update openal-soft to 1.23.1 2023-05-03 18:59:33 +08:00
presets Update thirdparty libs 2023-02-04 15:03:54 +08:00
resources Rename external to thirdparty [ci build] 2021-06-08 20:45:55 +08:00
router Update thirdparty libs 2023-02-04 15:03:54 +08:00
BSD-3Clause Rename external to thirdparty [ci build] 2021-06-08 20:45:55 +08:00
CMakeLists.txt Update openal-soft to 1.23.1 2023-05-03 18:59:33 +08:00
COPYING Rename external to thirdparty [ci build] 2021-06-08 20:45:55 +08:00
ChangeLog Update openal-soft to 1.23.1 2023-05-03 18:59:33 +08:00
README.md Update thirdparty libs 2023-02-04 15:03:54 +08:00
XCompile-Android.txt Rename external to thirdparty [ci build] 2021-06-08 20:45:55 +08:00
XCompile.txt Rename external to thirdparty [ci build] 2021-06-08 20:45:55 +08:00
config.h.in Windows Store UWP apps support (#1108) 2023-03-11 22:10:18 +08:00
libopenal.version Add openal missing file 2023-05-03 19:17:51 +08:00
openal.pc.in Rename external to thirdparty [ci build] 2021-06-08 20:45:55 +08:00
version.cmake Rename external to thirdparty [ci build] 2021-06-08 20:45:55 +08:00
version.h.in Upgrade thirdparty stubs 2022-07-14 23:17:11 +08:00

README.md

OpenAL Soft

master branch CI status : GitHub Actions Status Windows Build Status

OpenAL Soft is an LGPL-licensed, cross-platform, software implementation of the OpenAL 3D audio API. It's forked from the open-sourced Windows version available originally from openal.org's SVN repository (now defunct). OpenAL provides capabilities for playing audio in a virtual 3D environment. Distance attenuation, doppler shift, and directional sound emitters are among the features handled by the API. More advanced effects, including air absorption, occlusion, and environmental reverb, are available through the EFX extension. It also facilitates streaming audio, multi-channel buffers, and audio capture.

More information is available on the official website.

Source Install

To install OpenAL Soft, use your favorite shell to go into the build/ directory, and run:

cmake ..

Alternatively, you can use any available CMake front-end, like cmake-gui, ccmake, or your preferred IDE's CMake project parser.

Assuming configuration went well, you can then build it. The command cmake --build . will instruct CMake to build the project with the toolchain chosen during configuration (often GNU Make or NMake, although others are possible).

Please Note: Double check that the appropriate backends were detected. Often, complaints of no sound, crashing, and missing devices can be solved by making sure the correct backends are being used. CMake's output will identify which backends were enabled.

For most systems, you will likely want to make sure PipeWire, PulseAudio, and ALSA were detected (if your target system uses them). For Windows, make sure WASAPI was detected.

Building openal-soft - Using vcpkg

You can download and install openal-soft using the vcpkg dependency manager:

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install openal-soft

The openal-soft port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please create an issue or pull request on the vcpkg repository.

Utilities

The source package comes with an informational utility, openal-info, and is built by default. It prints out information provided by the ALC and AL sub- systems, including discovered devices, version information, and extensions.

Configuration

OpenAL Soft can be configured on a per-user and per-system basis. This allows users and sysadmins to control information provided to applications, as well as application-agnostic behavior of the library. See alsoftrc.sample for available settings.

Acknowledgements

Special thanks go to:

  • Creative Labs for the original source code this is based off of.
  • Christopher Fitzgerald for the current reverb effect implementation, and helping with the low-pass and HRTF filters.
  • Christian Borss for the 3D panning code previous versions used as a base.
  • Ben Davis for the idea behind a previous version of the click-removal code.
  • Richard Furse for helping with my understanding of Ambisonics that is used by the various parts of the library.