#[non_exhaustive]pub struct AudioNormalizationSettings {
pub algorithm: Option<AudioNormalizationAlgorithm>,
pub algorithm_control: Option<AudioNormalizationAlgorithmControl>,
pub correction_gate_level: Option<i32>,
pub loudness_logging: Option<AudioNormalizationLoudnessLogging>,
pub peak_calculation: Option<AudioNormalizationPeakCalculation>,
pub target_lkfs: Option<f64>,
pub true_peak_limiter_threshold: Option<f64>,
}
Expand description
Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.algorithm: Option<AudioNormalizationAlgorithm>
Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
algorithm_control: Option<AudioNormalizationAlgorithmControl>
When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.
correction_gate_level: Option<i32>
Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.
loudness_logging: Option<AudioNormalizationLoudnessLogging>
If set to LOG, log each output’s audio track loudness to a CSV file.
peak_calculation: Option<AudioNormalizationPeakCalculation>
If set to TRUE_PEAK, calculate and log the TruePeak for each output’s audio track loudness.
target_lkfs: Option<f64>
When you use Audio normalization, optionally use this setting to specify a target loudness. If you don’t specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS.
true_peak_limiter_threshold: Option<f64>
Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0.
Implementations§
source§impl AudioNormalizationSettings
impl AudioNormalizationSettings
sourcepub fn algorithm(&self) -> Option<&AudioNormalizationAlgorithm>
pub fn algorithm(&self) -> Option<&AudioNormalizationAlgorithm>
Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
sourcepub fn algorithm_control(&self) -> Option<&AudioNormalizationAlgorithmControl>
pub fn algorithm_control(&self) -> Option<&AudioNormalizationAlgorithmControl>
When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.
sourcepub fn correction_gate_level(&self) -> Option<i32>
pub fn correction_gate_level(&self) -> Option<i32>
Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.
sourcepub fn loudness_logging(&self) -> Option<&AudioNormalizationLoudnessLogging>
pub fn loudness_logging(&self) -> Option<&AudioNormalizationLoudnessLogging>
If set to LOG, log each output’s audio track loudness to a CSV file.
sourcepub fn peak_calculation(&self) -> Option<&AudioNormalizationPeakCalculation>
pub fn peak_calculation(&self) -> Option<&AudioNormalizationPeakCalculation>
If set to TRUE_PEAK, calculate and log the TruePeak for each output’s audio track loudness.
sourcepub fn target_lkfs(&self) -> Option<f64>
pub fn target_lkfs(&self) -> Option<f64>
When you use Audio normalization, optionally use this setting to specify a target loudness. If you don’t specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS.
sourcepub fn true_peak_limiter_threshold(&self) -> Option<f64>
pub fn true_peak_limiter_threshold(&self) -> Option<f64>
Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0.
source§impl AudioNormalizationSettings
impl AudioNormalizationSettings
sourcepub fn builder() -> AudioNormalizationSettingsBuilder
pub fn builder() -> AudioNormalizationSettingsBuilder
Creates a new builder-style object to manufacture AudioNormalizationSettings
.
Trait Implementations§
source§impl Clone for AudioNormalizationSettings
impl Clone for AudioNormalizationSettings
source§fn clone(&self) -> AudioNormalizationSettings
fn clone(&self) -> AudioNormalizationSettings
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for AudioNormalizationSettings
impl Debug for AudioNormalizationSettings
source§impl PartialEq for AudioNormalizationSettings
impl PartialEq for AudioNormalizationSettings
source§fn eq(&self, other: &AudioNormalizationSettings) -> bool
fn eq(&self, other: &AudioNormalizationSettings) -> bool
self
and other
values to be equal, and is used
by ==
.impl StructuralPartialEq for AudioNormalizationSettings
Auto Trait Implementations§
impl Freeze for AudioNormalizationSettings
impl RefUnwindSafe for AudioNormalizationSettings
impl Send for AudioNormalizationSettings
impl Sync for AudioNormalizationSettings
impl Unpin for AudioNormalizationSettings
impl UnwindSafe for AudioNormalizationSettings
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more