Properly check for struct timespec
[openal-soft.git] / docs / 3D7.1.txt
blob1d40bec65320386ed76cd80a79374713f61a3138
1 Overview
2 ========
4 3D7.1 is a custom speaker layout designed by Simon Goodwin at Codemasters[1].
5 Typical surround sound setups, like quad, 5.1, 6.1, and 7.1, only produce audio
6 on a 2D horizontal plane with no verticality, which means the envelopment of
7 "surround" sound is limited to left, right, front, and back panning. Sounds
8 that should come from above or below will still only play in 2D since there is
9 no height difference in the speaker array.
11 To work around this, 3D7.1 was designed so that some speakers are placed higher
12 than the listener while others are lower, in a particular configuration that
13 tries to provide balanced output and maintain some compatibility with existing
14 audio content and software. Software that recognizes this setup, or can be
15 configured for it, can then take advantage of the height difference and
16 increase the perception of verticality for true 3D audio. The result is that
17 sounds can be perceived as coming from left, right, front, and back, as well as
18 up and down.
20 [1] http://www.codemasters.com/research/3D_sound_for_3D_games.pdf
23 Hardware Setup
24 ==============
26 Setting up 3D7.1 requires an audio device capable of raw 8-channel or 7.1
27 output, along with a 7.1 speaker kit. The speakers should be hooked up to the
28 device in the usual way, with front-left and front-right output going to the
29 front-left and front-right speakers, etc. The placement of the speakers should
30 be set up according to the table below. Azimuth is the horizontal angle in
31 degrees, with 0 directly in front and positive values go /left/, and elevation
32 is the vertical angle in degrees, with 0 at head level and positive values go
33 /up/.
35 ------------------------------------------------------------
36 - Speaker label | Azimuth | Elevation |      New label     -
37 ------------------------------------------------------------
38 - Front left    |    51   |     24    |   Upper front left -
39 - Front right   |   -51   |     24    |  Upper front right -
40 - Front center  |     0   |      0    |       Front center -
41 - Subwoofer/LFE |   N/A   |    N/A    |      Subwoofer/LFE -
42 - Side left     |   129   |    -24    |    Lower back left -
43 - Side right    |  -129   |    -24    |   Lower back right -
44 - Back left     |   180   |     55    |  Upper back center -
45 - Back right    |     0   |    -55    | Lower front center -
46 ------------------------------------------------------------
48 Note that this speaker layout *IS NOT* compatible with standard 7.1 content.
49 Audio that should be played from the back will come out at the wrong location
50 since the back speakers are placed in the lower front and upper back positions.
51 However, this speaker layout *IS* more or less compatible with standard 5.1
52 content. Though slightly tilted, to a listener sitting a bit further back from
53 the center, the front and side speakers will be close enough to their intended
54 locations that the output won't be too off.
57 Software Setup
58 ==============
60 To enable 3D7.1 on OpenAL Soft, first make sure the audio device is configured
61 for 7.1 output. Then in the alsoft-config utility, under the Renderer tab,
62 select the 3D7.1.ambdec preset for the 7.1 Surround decoder configuration. And
63 that's it. Any applications using OpenAL Soft can take advantage of fully 3D
64 audio, and multi-channel sounds will be properly remixed for the speaker
65 layout.
67 Playback can be improved by (copying and) modifying the 3D7.1.ambdec preset,
68 changing the specified speaker distances to match the the real distance (in
69 meters) from the center of the speaker array, then enable High Quality Mode in
70 alsoft-config. That will improve the quality when the speakers are not all
71 equidistant.
73 Note that care must be taken that the audio device is not treated as a "true"
74 7.1 device by non-3D7.1-capable applications. In particular, the audio server
75 should not try to upmix stereo and 5.1 content to "fill out" the back speakers,
76 and non-3D7.1 apps should be set to either stereo or 5.1 output.
78 As such, if your system is capable of it, it may be useful to define a virtual
79 5.1 device that maps the front, side, and LFE channels to the main device for
80 output and disables upmixing, then use that virtual 5.1 device for apps that do
81 normal stereo or surround sound output, and use the main device for apps that
82 understand 3D7.1 output.