Use unique setters for biquad filter parameters
[openal-soft.git] / presets / presets.txt
blob541416e24898a58cf8cc7d3349caec360a909fa9
1 Ambisonic decoder configuration presets are provided here for common surround
2 sound speaker layouts. The presets are prepared to work with OpenAL Soft's high
3 quality decoder. By default all of the speaker distances within a preset are
4 set to the same value, which results in no effect from distance compensation.
5 If this doesn't match your physical speaker setup, it may be worth copying the
6 preset and modifying the distance values to match (note that modifying the
7 azimuth and elevation values in the presets will not have any effect; the
8 specified angles do not change the decoder behavior).
10 Details of the individual presets are as follows.
12 square.ambdec
13 Specifies a basic square speaker setup for Quadraphonic output, with identical
14 width and depth. Front speakers are placed at +45 and -45 degrees, and back
15 speakers are placed at +135 and -135 degrees.
17 rectangle.ambdec
18 Specifies a narrower speaker setup for Quadraphonic output, with a little less
19 width but a little more depth over a basic square setup. Front speakers are
20 placed at +30 and -30 degrees, providing a bit more compatibility for existing
21 stereo content, with back speakers at +150 and -150 degrees.
23 itu5.1.ambdec
24 Specifies a standard ITU 5.0/5.1 setup for 5.1 Surround output. The front-
25 center speaker is placed directly in front at 0 degrees, with the front-left
26 and front-right at +30 and -30 degrees, and the surround speakers (side or
27 back) at +110 and -110 degrees.
29 hexagon.ambdec
30 Specifies a flat-front hexagonal speaker setup for 7.1 Surround output. The
31 front left and right speakers are placed at +30 and -30 degrees, the side
32 speakers are placed at +90 and -90 degrees, and the back speakers are placed at
33 +150 and -150 degrees. Although this is for 7.1 output, no front-center speaker
34 is defined for the decoder, meaning that speaker will be silent for 3D sound
35 (however it may still be used with AL_SOFT_direct_channels or ALC_EXT_DEDICATED
36 output). A "proper" 7.1 decoder may be provided in the future, but due to the
37 nature of the speaker configuration will have trade-offs.
39 3D7.1.ambdec
40 Specifies a 3D7.1 speaker setup for 7.1 Surround output. Although it's for 7.1
41 output, the speakers for such a configuration need to be placed in different
42 positions for proper results. Please see docs/3D7.1.txt for more information.