Subsystem Search

Subsample configuration: ambisonic

The 5 settings under ambisonic, each with the type, default and limits its schema declares.

How Subsample rotates and decodes first-order ambisonic samples at playback. Applies only to samples captured with recorder.audio.ambisonic_format set, which Subsample stores as AmbiX B-format, and applies to every such sample in the project.

decoder in ambisonic

Type
string
Default
basic
Limits
one of basic, inphase, max_re

Decoder weighting that maps B-format onto the output speaker layout. basic places each sound most sharply, and plays a little of it from the speakers opposite, inverted. max_re puts the most of each sound's energy in its own direction, the usual choice for 5.1 and 7.1. inphase never plays a speaker inverted and gives the softest image, for listening away from the centre.

yaw_degrees in ambisonic

Type
number
Default
0

Rotation of the sound field about the vertical axis, in degrees, applied before decoding. Positive values turn it anticlockwise seen from above, moving a sound at the front towards the left.

pitch_degrees in ambisonic

Type
number
Default
0

Rotation about the left-right axis, in degrees, applied before decoding. Positive values tilt the front downwards, moving a sound at the front towards below.

roll_degrees in ambisonic

Type
number
Default
0

Rotation about the front-back axis, in degrees, applied before decoding. Positive values tilt the field to the right, moving a sound on the left towards above.

max_order in ambisonic

Type
integer
Default
1
Limits
one of 1

Ambisonic order to decode. Only first order is supported.