Fold the rear surrounds for warp modes 2 and 3
The OAMD warp field is two bits wide; modes 2 and 3 now render instead of failing. For a 5.1, 5.1.2 or 5.1.4 target the speaker renderer pans objects in the corresponding 7.1, 7.1.2 or 7.1.4 intermediate layout and folds the rear pair into the target surround pair: mode 2 uses the PLIIx coefficients (sqrt(3)/2 and 1/2), mode 3 the Standard (Lo/Ro) coefficients (1 and 0). 4.0 gains a rear pair the same way, built from the 7.1 geometry without a centre or LFE channel. Layouts that already have both surround pairs, or none, render directly. The intermediate layout only changes geometry and panning. Trim configuration selection, both balance layers and the automatic position compensation stay with the final target layout, so 5.1.2 keeps configuration 4 and its compensation while panning on 7.1.2. Per-object bypass drops balance and trim but keeps the fold, and LFE still passes through. The folded object vector enters the existing gain ramp and mix unchanged; the public API and the ADM metadata do not change. parameters_from_oamd accepts the whole two-bit warp field and rejects values above 3; the renderer builds the fold matrices once per layout and keeps the 4.0 intermediate geometry internally. The bilingual notes describe the fold and the evaluation order, and the READMEs no longer call 2/3 unsupported. ctest covers PLIIx and Lo/Ro on 5.1, 5.1.2, 5.1.4 and 4.0, the target-layout calibration, bypass, LFE and the event path; speaker output over the shared objects16 stream is byte-identical to the reference for all layouts in both warp modes 2 and 3.
This commit is contained in:
1 parent
58e3403642
commit
a2760286b0
9 files changed
+426
-41
No files matched your search
+5
-5
@@ -143,11 +143,11 @@ downstream player recognises Dolby speaker positions on its own.
|
||||
`--speaker-layout` accepts only the eleven names in the table; anything else fails as an unknown
|
||||
layout.
|
||||
|
||||
Speaker rendering reads warp 0/1, trim and front/back balance from the OAMD metadata; the CLI
|
||||
has no warp override, and warp 2/3 is reported as unsupported at render time. Trim and balance
|
||||
apply to the 2.0, 3.1, 4.0, 5.1, 5.1.2, 5.1.4 and 7.1 layouts. Source trajectories and binaural
|
||||
rendering do not pre-apply these controls; see [mathematics §12](docs/math.en.md) for the
|
||||
parameters and evaluation order.
|
||||
Speaker rendering reads warp, trim and front/back balance from the OAMD metadata; the CLI has no
|
||||
warp override. Warp 0/1 render directly; warp 2/3 render to a 7.1.x intermediate layout first,
|
||||
then fold back to 5.1.x with PLIIx or Standard (Lo/Ro) coefficients, and calibration always
|
||||
follows the final target layout. Source trajectories and binaural rendering do not pre-apply
|
||||
these controls; see [mathematics §12](docs/math.en.md) for the parameters and evaluation order.
|
||||
|
||||
## Library integration
|
||||
|
||||
|
||||
Reference in new issue
Block a user