README.md

   1 OpenAL soft
   2 ===========
   3
   4 `master` branch CI status :  [![Build Status](https://travis-ci.org/kcat/openal-soft.svg?branch=master)](https://travis-ci.org/kcat/openal-soft) [![Windows Build Status](https://ci.appveyor.com/api/projects/status/github/kcat/openal-soft?branch=master&svg=true)](https://ci.appveyor.com/api/projects/status/github/kcat/openal-soft?branch=master&svg=true)
   5
   6 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).
   7 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.
   8
   9 More information is available on the [official website](http://openal-soft.org/)
  10
  11 Source Install
  12 -------------
  13 To install OpenAL Soft, use your favorite shell to go into the build/
  14 directory, and run:
  15
  16 ```bash
  17 cmake ..
  18 ```
  19
  20 Assuming configuration went well, you can then build it, typically using GNU
  21 Make (KDevelop, MSVC, and others are possible depending on your system setup
  22 and CMake configuration).
  23
  24 Please Note: Double check that the appropriate backends were detected. Often,
  25 complaints of no sound, crashing, and missing devices can be solved by making
  26 sure the correct backends are being used. CMake's output will identify which
  27 backends were enabled.
  28
  29 For most systems, you will likely want to make sure ALSA, OSS, and PulseAudio
  30 were detected (if your target system uses them). For Windows, make sure
  31 DirectSound was detected.
  32
  33
  34 Utilities
  35 ---------
  36 The source package comes with an informational utility, openal-info, and is
  37 built by default. It prints out information provided by the ALC and AL sub-
  38 systems, including discovered devices, version information, and extensions.
  39
  40
  41 Configuration
  42 -------------
  43
  44 OpenAL Soft can be configured on a per-user and per-system basis. This allows
  45 users and sysadmins to control information provided to applications, as well
  46 as application-agnostic behavior of the library. See alsoftrc.sample for
  47 available settings.
  48
  49
  50 Acknowledgements
  51 ----------------
  52
  53 Special thanks go to:
  54
  55  - Creative Labs for the original source code this is based off of.
  56  - Christopher Fitzgerald for the current reverb effect implementation, and
  57 helping with the low-pass and HRTF filters.
  58  - Christian Borss for the 3D panning code previous versions used as a base.
  59  - Ben Davis for the idea behind a previous version of the click-removal code.
  60  - Richard Furse for helping with my understanding of Ambisonics that is used by
  61 the various parts of the library.