kcat
/
openal-soft
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update some outdated docs

master
Chris Robinson 2022-07-17 13:26:48 -07:00
parent 4cbb271819
commit 263e9aab11
2 changed files with 8 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/ambdec.txt
View File

@ -157,9 +157,8 @@ CE = Front center
CB = Back center
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

19
docs/ambisonics.txt
View File

@ -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