Initial commit

added libraries:
opus
flac
libsndfile

updated:
libvorbis
libogg
openal

- Everything works as expected for now. Bare in mind libsndfile needed the check for whether or not it could find the xiph libraries removed in order for this to work.

Engine/lib/openal-soft/docs/3D7.1.txt

@@ -58,17 +58,10 @@ Software Setup
 ==============
 
 To enable 3D7.1 on OpenAL Soft, first make sure the audio device is configured
-for 7.1 output. Then in the alsoft-config utility, under the Renderer tab,
-select the 3D7.1.ambdec preset for the 7.1 Surround decoder configuration. And
-that's it. Any applications using OpenAL Soft can take advantage of fully 3D
-audio, and multi-channel sounds will be properly remixed for the speaker
-layout.
-
-Playback can be improved by (copying and) modifying the 3D7.1.ambdec preset,
-changing the specified speaker distances to match the the real distance (in
-meters) from the center of the speaker array, then enable High Quality Mode in
-alsoft-config. That will improve the quality when the speakers are not all
-equidistant.
+for 7.1 output. Then in the alsoft-config utility, for the Channels setting
+choose "3D7.1 Surround" from the drop-down list. And that's it. Any application
+using OpenAL Soft can take advantage of fully 3D audio, and multi-channel
+sounds will be properly remixed for the speaker layout.
 
 Note that care must be taken that the audio device is not treated as a "true"
 7.1 device by non-3D7.1-capable applications. In particular, the audio server

Engine/lib/openal-soft/docs/ambdec.txt

@@ -13,7 +13,7 @@ about ambisonics.
 
 Starting with OpenAL Soft 1.18, version 3 of the file format is supported as a
 means of specifying custom surround sound speaker layouts. These configuration
-files are also used to enable the high-quality ambisonic decoder.
+files are also used to enable per-speaker distance compensation.
 
 
 File Format
@@ -155,11 +155,14 @@ LB = Back left
 RB = Back right
 CE = Front center
 CB = Back center
+LFT = Top front left
+RFT = Top front right
+LBT = Top back left
+RBT = Top back right
 
 Additionally, configuration files for surround51 will acknowledge back speakers
-for side channels, and surround51rear will acknowledge side speakers for back
-channels, to avoid issues with a configuration expecting 5.1 to use the side
-channels when the device is configured for back, or vice-versa.
+for side channels, to avoid issues with a configuration expecting 5.1 to use
+the side channels when the device is configured for back, or vice-versa.
 
 Furthermore, OpenAL Soft does not require a speaker definition for each output
 channel the configuration is used with. So for example a 5.1 configuration may

Engine/lib/openal-soft/docs/ambisonics.txt

@@ -72,19 +72,12 @@ How Is It Used?
 ===============
 
 As a 3D audio API, OpenAL is tasked with playing 3D sound as best it can with
-the speaker setup the user has. Since the OpenAL API does not explicitly handle
-the output channel configuration, it has a lot of leeway in how to deal with
-the audio before it's played back for the user to hear. Consequently, OpenAL
-Soft (or any other OpenAL implementation that wishes to) can render using
-Ambisonics and decode the ambisonic mix for a high level of accuracy over what
-simple pan-pot could provide.
-
-When given an appropriate decoder configuration for the channel layout, the
-ambisonic mix can be decoded utilizing the benefits available to ambisonic
-processing, including frequency-dependent processing and near-field effects.
-Without a decoder configuration, the ambisonic mix can still be decoded for
-good stereo or surround sound output, although without near-field effects as
-there's no speaker distance information.
+the speaker setup the user has. Since the OpenAL API doesn't expose discrete
+playback speaker feeds, an implementation has a lot of leeway with how to deal
+with the audio before it's played back for the user to hear. Consequently,
+OpenAL Soft (or any other OpenAL implementation that wishes to) can render
+using Ambisonics and decode the ambisonic mix for a high level of accuracy over
+what simple pan-pot could provide.
 
 In addition to surround sound output, Ambisonics also has benefits with stereo
 output. 2-channel UHJ is a stereo-compatible format that encodes some surround

Engine/lib/openal-soft/docs/env-vars.txt

@@ -58,6 +58,12 @@ between 0 and 180 degrees, instead of the expected range of 0 to 360 degrees.
 Setting this to "true" or "1" restores the old buggy behavior, for apps that
 were written to expect the incorrect range.
 
+__ALSOFT_ENABLE_SUB_DATA_EXT
+The more widely used AL_EXT_SOURCE_RADIUS extension is incompatible with the
+now-defunct AL_SOFT_buffer_sub_data extension. Setting this to "true" or "1"
+restores the AL_SOFT_buffer_sub_data extension for apps that require it,
+disabling AL_EXT_SOURCE_RADIUS.
+
 __ALSOFT_REVERSE_Z
 Applications that don't natively use OpenAL's coordinate system have to convert
 to it before passing in 3D coordinates. Depending on how exactly this is done,

Engine/lib/openal-soft/docs/hrtf.txt

@@ -73,9 +73,7 @@ calculation (ie. left = angle, right = 360-angle).
 The actual coefficients follow. Each coefficient is a signed 24-bit sample.
 Stereo HRTFs interleave left/right ear coefficients.  The HRIRs must be
 minimum-phase.  This allows the use of a smaller filter length, reducing
-computation.  For reference, the default data set uses a 32-point filter while
-even the smallest data set provided by MIT used a 128-sample filter (a 4x
-reduction by applying minimum-phase reconstruction).
+computation.
 
 After the coefficients is an array of unsigned 8-bit delay values as 6.2 fixed-
 point integers, one for each HRIR (with stereo HRTFs interleaving left/right