Struct AudioNormalizationSettings 

#[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>,
}

Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional 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

impl AudioNormalizationSettings

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.

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.

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.

pub fn loudness_logging(&self) -> Option<&AudioNormalizationLoudnessLogging>

If set to LOG, log each output’s audio track loudness to a CSV file.

pub fn peak_calculation(&self) -> Option<&AudioNormalizationPeakCalculation>

If set to TRUE_PEAK, calculate and log the TruePeak for each output’s audio track loudness.

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.

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.

impl AudioNormalizationSettings

pub fn builder() -> AudioNormalizationSettingsBuilder

Creates a new builder-style object to manufacture AudioNormalizationSettings.

Trait Implementations

impl Clone for AudioNormalizationSettings

fn clone(&self) -> AudioNormalizationSettings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AudioNormalizationSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for AudioNormalizationSettings

fn eq(&self, other: &AudioNormalizationSettings) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AudioNormalizationSettings