libear — Recommendation ITU-R BS.2127 core library¶
libear is a C++14 library to render ADM content according to [bs2127]. It is not a complete application, but provides components to calculate gains and apply them to audio, for embedding into applications which need to render ADM content.
Rendering of ADM content is performed by two distinct processes:
Calculating gains to apply to the input audio samples, as described in Calculating Gains.
Applying those gains to the input audio samples to produce output audio samples, as described in DSP.
To get started, check out the Installation instructions.
Support¶
DirectSpeakers, Objects and HOA typeDefinitions are supported, though the following parameters/features are currently not implemented:
Objects:
Cartesian positions, or
cartesian == true
divergence
zoneExclusion
channelLock
screenRef
screenEdgeLock
DirectSpeakers:
Cartesian positions
screenEdgeLock
All types:
M-SC
andM+SC
loudspeakers with azimuths wider than 25 degrees
libear aims to be a complete renderer implementation; these deficiencies will be addressed in future releases.
libear does not include functionality to read BW64 files or parse ADM XML data; for that functionality we recommend using libbw64 and libadm.
License¶
Copyright 2019 The libear Authors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.