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].