aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorArthur Brainville <[email protected]>2018-01-28 01:37:00 +0100
committerArthur Brainville <[email protected]>2018-01-28 01:37:00 +0100
commit6562a939ea5a5b582d6aa182f3f6fa7411a5e222 (patch)
treebcc2dea78b712ba4c9caf0063f13d4f7a8a9c667 /README.md
parent031cf248808df8cc7d0af2a5c5174d189af7a4ac (diff)
Add project overview and travis build badge
Signed-off-by: Arthur Brainville (Ybalrid) <[email protected]>
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 14 insertions, 6 deletions
diff --git a/README.md b/README.md
index 3071163f..42d12fda 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,15 @@
-Source Install
-==============
+OpenAL-soft
+===========
+
+CI status : [![Build Status](https://travis-ci.org/kcat/openal-soft.svg?branch=master)](https://travis-ci.org/kcat/openal-soft)
+
+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 available on the [official website](http://openal-soft.org/)
+
+Source Install
+-------------
To install OpenAL Soft, use your favorite shell to go into the build/
directory, and run:
@@ -23,15 +32,14 @@ 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
@@ -40,7 +48,7 @@ available settings.
Acknowledgements
-================
+----------------
Special thanks go to: