From 263e9aab1147925202514908875b44259f5d1d18 Mon Sep 17 00:00:00 2001 From: Chris Robinson <chris.kcat@gmail.com> Date: Sun, 17 Jul 2022 13:26:48 -0700 Subject: Update some outdated docs --- docs/ambdec.txt | 5 ++--- docs/ambisonics.txt | 19 ++++++------------- 2 files changed, 8 insertions(+), 16 deletions(-) (limited to 'docs') diff --git a/docs/ambdec.txt b/docs/ambdec.txt index 1f328937..5565ae06 100644 --- a/docs/ambdec.txt +++ b/docs/ambdec.txt @@ -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 diff --git a/docs/ambisonics.txt b/docs/ambisonics.txt index b03e3bed..b1b111d6 100644 --- a/docs/ambisonics.txt +++ b/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 -- cgit v1.2.3