rlm@0: Source Install rlm@0: ============== rlm@0: rlm@0: To install OpenAL Soft, use your favorite shell to go into the build/ rlm@0: directory, and run: rlm@0: rlm@0: cmake .. rlm@0: rlm@0: Assuming configuration went well, you can then build it, typically using GNU rlm@0: Make (KDevelop, MSVC, and others are possible depending on your system setup rlm@0: and CMake configuration). rlm@0: rlm@0: Please Note: Double check that the appropriate backends were detected. Often, rlm@0: complaints of no sound, crashing, and missing devices can be solved by making rlm@0: sure the correct backends are being used. CMake's output will identify which rlm@0: backends were enabled. rlm@0: rlm@0: For most systems, you will likely want to make sure ALSA, OSS, and PulseAudio rlm@0: were detected (if your target system uses them). For Windows, make sure rlm@0: DirectSound was detected. rlm@0: rlm@0: rlm@0: Utilities rlm@0: ========= rlm@0: rlm@0: The source package comes with an informational utility, openal-info, and is rlm@0: built by default. It prints out information provided by the ALC and AL sub- rlm@0: systems, including discovered devices, version information, and extensions. rlm@0: rlm@0: rlm@0: Configuration rlm@0: ============= rlm@0: rlm@0: OpenAL Soft can be configured on a per-user and per-system basis. This allows rlm@0: users and sysadmins to control information provided to applications, as well rlm@0: as application-agnostic behavior of the library. See alsoftrc.sample for rlm@0: available settings. rlm@0: rlm@0: rlm@0: Acknowledgements rlm@0: ================ rlm@0: rlm@0: Special thanks go to: rlm@0: rlm@0: Creative Labs for the original source code this is based off of. rlm@0: rlm@0: Christopher Fitzgerald for the current reverb effect implementation, and rlm@0: helping with the low-pass filter. rlm@0: rlm@0: Christian Borss for the 3D panning code the current implementation is heavilly rlm@0: based on. rlm@0: rlm@0: Ben Davis for the idea behind the current click-removal code.