🛠️🐜 Antkeeper superbuild with dependencies included https://antkeeper.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
C. J. Howard 3e57c58b94 Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
..
Alc Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
OpenAL32 Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
cmake Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
common Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
docs Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
examples Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
hrtf Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
include/AL Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
native-tools Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
presets Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
router Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
utils Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
.gitignore Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
.travis.yml Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
CMakeLists.txt Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
COPYING Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
ChangeLog Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
README.md Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
XCompile-Android.txt Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
XCompile.txt Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
alsoftrc.sample Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
appveyor.yml Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
config.h.in Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
openal.pc.in Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
version.cmake Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago
version.h.in Move dependencies from antkeeper-source submodule to superbuild repo 4 years ago

README.md

OpenAL soft

master branch CI status : Build 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 ..

Assuming configuration went well, you can then build it, typically using GNU Make (KDevelop, MSVC, and others are possible depending on your system setup and CMake configuration).

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 ALSA, OSS, and PulseAudio were detected (if your target system uses them). For Windows, make sure DirectSound was detected.

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.