Loudspeaker LayoutsΒΆ
An output loudspeaker layout is represented by Layout
, which contains
a name, a list of Channel
objects, and the reference Screen
.
Loudspeaker layouts specified in [bs2051] are supported, including
positions within the ranges specified. The function getLayout()
is
therefore provided to obtain a Layout
object given the layout name,
e.g. 4+5+0
.
When using layouts with non-nominal positions, the
Channel::polarPositionNominal()
must match the position specified in Table
1 in [bs2051], and the Channel::polarPosition()
must meet the
specified constraints, including azimuth/elevation ranges and symmetry
requirements.
Non-standard loudspeaker layouts may be used, however their behaviour may change in future versions of the library. Loudspeaker layouts must be similar to those in [bs2051], with 1, 2 or 3 layers and an optional T+000 or UH+180 loudspeaker. Using this functionality requires some understanding of the internals of the renderer, particularly section 6.1.3.1 of [bs2127].