Rename some cmake target names to avoid conflicts
[openal-soft.git] / docs / 3D7.1.txt
blobb7249c2291446270fb002f2d6b3500d3e44bdaa5
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, for the Channels setting
62 choose "3D7.1 Surround" from the drop-down list. And that's it. Any application
63 using OpenAL Soft can take advantage of fully 3D audio, and multi-channel
64 sounds will be properly remixed for the speaker layout.
66 Note that care must be taken that the audio device is not treated as a "true"
67 7.1 device by non-3D7.1-capable applications. In particular, the audio server
68 should not try to upmix stereo and 5.1 content to "fill out" the back speakers,
69 and non-3D7.1 apps should be set to either stereo or 5.1 output.
71 As such, if your system is capable of it, it may be useful to define a virtual
72 5.1 device that maps the front, side, and LFE channels to the main device for
73 output and disables upmixing, then use that virtual 5.1 device for apps that do
74 normal stereo or surround sound output, and use the main device for apps that
75 understand 3D7.1 output.